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 vor der Verwendung auf produktiven Webseiten.
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 backgroundfetchabort-Ereignis des ServiceWorkerGlobalScope Interfaces wird ausgelöst, wenn der Benutzer oder die App selbst eine Hintergrundanforderung abbricht.
Dieses Ereignis kann nicht abgebrochen werden und löst sich nicht in Kettenreaktionen aus.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("backgroundfetchabort", (event) => { })
onbackgroundfetchabort = (event) => { }
Ereignistyp
Ein BackgroundFetchEvent.
Ereigniseigenschaften
Erbt Eigenschaften von seinem Elternteil, ExtendableEvent.
BackgroundFetchEvent.registration-
Gibt die
BackgroundFetchRegistrationfür die abgebrochene Anforderung zurück.
Beschreibung
In der Hintergrundabruf-API zeigt der Browser ein UI-Element an, um dem Benutzer den Fortschritt der Operation anzuzeigen. Dieses Element ermöglicht es dem Benutzer auch, die Anforderung abzubrechen. Die App selbst kann die Anforderung auch abbrechen, indem sie BackgroundFetchRegistration.abort() aufruft.
Wenn die Anforderung abgebrochen wird, bricht der Browser die Anforderung ab, startet bei Bedarf den Service Worker und löst das backgroundfetchabort-Ereignis im globalen Bereich des Service Workers aus.
Im Handler für dieses Ereignis kann der Service Worker alle zugehörigen Daten der Operation bereinigen. Er kann auch erfolgreiche 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
Aufräumen
Dieser Ereignis-Handler könnte eine Bereinigung der Daten durchführen, die mit der abgebrochenen Anforderung verbunden sind.
addEventListener("backgroundfetchabort", (event) => {
// clean up any related data
});
Spezifikationen
| Specification |
|---|
| Background Fetch # dom-serviceworkerglobalscope-onbackgroundfetchabort |