ServiceWorkerGlobalScope: backgroundfetchabort Ereignis
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Dieses Feature ist nur verfügbar in Service Workers.
Das backgroundfetchabort
Ereignis des ServiceWorkerGlobalScope
Interface wird ausgelöst, wenn der Benutzer oder die App selbst eine Background Fetch Operation abbricht.
Dieses Ereignis ist nicht abbruchbar und wird nicht weitergereicht.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
oder legen Sie eine Ereignisbehandler-Eigenschaft fest.
addEventListener("backgroundfetchabort", (event) => {});
onbackgroundfetchabort = (event) => {};
Ereignistyp
Ein BackgroundFetchEvent
.
Ereigniseigenschaften
Erbt Eigenschaften von seinem Elternteil, ExtendableEvent
.
BackgroundFetchEvent.registration
-
Gibt die
BackgroundFetchRegistration
für das abgebrochene Fetch zurück.
Beschreibung
In der Background Fetch API zeigt der Browser dem Benutzer ein UI-Element an, um den Fortschritt der Operation anzuzeigen. Dieses Element ermöglicht es dem Benutzer auch, das Fetch abzubrechen. Die App selbst kann das Fetch ebenfalls abbrechen, indem sie BackgroundFetchRegistration.abort()
aufruft.
Wenn das Fetch abgebrochen wird, bricht der Browser das Fetch ab, startet den Service Worker, falls erforderlich, und löst das backgroundfetchabort
Ereignis im globalen Bereich des Service Workers aus.
Im Handler für dieses Ereignis kann der Service Worker sämtliche zugehörigen Daten der Operation bereinigen. Er kann auch alle erfolgreichen Antworten abrufen und speichern (zum Beispiel mit der Cache
API). Um auf die Antwortdaten zuzugreifen, verwendet der Service Worker die registration
Eigenschaft des Ereignisses.
Beispiele
Bereinigung
Dieser Ereignis-Handler könnte eine Bereinigung der mit dem abgebrochenen Fetch verbundenen Daten durchführen.
addEventListener("backgroundfetchabort", (event) => {
// clean up any related data
});
Spezifikationen
Specification |
---|
Background Fetch # dom-serviceworkerglobalscope-onbackgroundfetchabort |
Browser-Kompatibilität
BCD tables only load in the browser