Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

ServiceWorkerGlobalScope: sync-Ereignis

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist nur in Service Workers verfügbar.

Das sync-Ereignis der Schnittstelle ServiceWorkerGlobalScope wird ausgelöst, wenn die Seite (oder der Worker), die das Ereignis mit dem SyncManager registriert hat, läuft und sobald Netzwerkverbindung verfügbar ist.

Dieses Ereignis ist nicht stornierbar und wird nicht weitergeleitet.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder legen Sie eine Ereignishandler-Eigenschaft fest.

js
addEventListener("sync", (event) => { })

onsync = (event) => { }

Ereignistyp

Ein SyncEvent. Erbt von ExtendableEvent und Event.

Event ExtendableEvent SyncEvent

Ereigniseigenschaften

Erbt Eigenschaften von seinem Vorfahren ExtendableEvent und Event.

SyncEvent.tag Schreibgeschützt

Gibt den entwicklerdefinierten Bezeichner für dieses SyncEvent zurück.

SyncEvent.lastChance Schreibgeschützt

Gibt true zurück, wenn der Benutzeragent nach dem aktuellen Versuch keine weiteren Synchronisierungsversuche unternehmen wird.

Beispiele

Das folgende Beispiel zeigt, wie Sie auf ein sync-Ereignis im Service Worker reagieren können.

js
self.addEventListener("sync", (event) => {
  if (event.tag === "sync-messages") {
    event.waitUntil(sendOutboxMessages());
  }
});

Sie können den Ereignishandler auch mit der onsync-Eigenschaft einrichten:

js
self.onsync = (event) => {
  // …
};

Spezifikationen

Specification
Web Background Synchronization
# dom-serviceworkerglobalscope-onsync

Browser-Kompatibilität

Siehe auch