SyncManager: register()-Methode

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die register()-Methode des SyncManager-Interfaces registriert ein Synchronisationsereignis, das ein sync-Ereignis innerhalb des zugehörigen Service Workers auslöst, sobald Netzwerkverbindung verfügbar ist.

In diesem Artikel

Syntax

Parameter

tag

Ein Bezeichner für dieses Synchronisationsereignis. Dies wird der Wert der tag-Eigenschaft des SyncEvent sein, das an den sync-Ereignishandler des Service Workers übergeben wird.

Rückgabewert

Ein Promise, das sich zu undefined auflöst.

Ausnahmen

InvalidStateError DOMException

Wird ausgelöst, wenn der aktuelle Service Worker nicht aktiv ist.

NotAllowedError DOMException

Wird ausgelöst, wenn der Hintergrund-Sync vom Benutzer deaktiviert wurde.

Beispiele

Die folgende asynchrone Funktion registriert einen Hintergrund-Sync aus einem Browserkontext:

js
async function syncMessagesLater() {
  const registration = await navigator.serviceWorker.ready;
  try {
    await registration.sync.register("sync-messages");
  } catch {
    console.log("Background Sync could not be registered!");
  }
}

Spezifikationen

Spezifikation

Web Background Synchronization
# dom-syncmanager-register

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Background Synchronization API
SyncManager
Instanzmethoden
1. getTags()
2. register()
Verwandte Seiten für Background Sync
1. ServiceWorkerRegistration.sync
2. SyncEvent