ServiceWorkerGlobalScope: backgroundfetchabort-Ereignis
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
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 der ServiceWorkerGlobalScope-Schnittstelle wird ausgelöst, wenn der Benutzer oder die App selbst eine Background Fetch-Operation abbricht.
Dieses Ereignis ist nicht abbruchfähig und nicht aufsteigend.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener(), oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("backgroundfetchabort", (event) => { })
onbackgroundfetchabort = (event) => { }
Ereignistyp
Ein BackgroundFetchEvent.
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, den Fetch abzubrechen. Die App selbst kann den Fetch auch abbrechen, indem sie BackgroundFetchRegistration.abort() aufruft.
Wenn der Fetch abgebrochen wird, bricht der Browser den Fetch ab, startet den Service Worker, falls erforderlich, und löst das backgroundfetchabort-Ereignis im globalen Scope des Service Workers aus.
Im Handler für dieses Ereignis kann der Service Worker alle zugehörigen Daten für die Operation bereinigen. Er kann auch alle erfolgreichen Antworten abrufen und speichern (zum Beispiel unter Verwendung 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 jegliche Bereinigung von Daten durchführen, die mit dem abgebrochenen Fetch verbunden sind.
addEventListener("backgroundfetchabort", (event) => {
// clean up any related data
});
Spezifikationen
| Spezifikation |
|---|
| Background Fetch # dom-serviceworkerglobalscope-onbackgroundfetchabort |