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 Schnittstelle ServiceWorkerGlobalScope wird ausgelöst, wenn der Benutzer oder die App selbst einen Background Fetch-Vorgang abbricht.
Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergereicht.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("backgroundfetchabort", (event) => { })
Alternativ können Sie ihn der Ereignishandler-Eigenschaft der Schnittstelle zuweisen:
onbackgroundfetchabort = (event) => { }
Ereignistyp
Ein BackgroundFetchEvent.
Beschreibung
Bei der Background Fetch API zeigt der Browser dem Benutzer ein UI-Element an, das den Fortschritt des Vorgangs darstellt. Über dieses Element kann der Benutzer den Fetch auch abbrechen. Die App selbst kann den Fetch ebenfalls abbrechen, indem sie BackgroundFetchRegistration.abort() aufruft.
Wird der Fetch abgebrochen, stoppt der Browser den Fetch, startet bei Bedarf den Service Worker und löst das backgroundfetchabort-Ereignis im globalen Gültigkeitsbereich des Service Workers aus.
Im Handler für dieses Ereignis kann der Service Worker zugehörige Daten des Vorgangs bereinigen. Er kann auch erfolgreiche Antworten abrufen und speichern, beispielsweise mithilfe der Cache-API. Um auf die Antwortdaten zuzugreifen, verwendet der Service Worker die registration-Eigenschaft des Ereignisses.
Beispiele
Bereinigung
Dieser Ereignishandler könnte Daten bereinigen, die mit dem abgebrochenen Fetch zusammenhängen.
addEventListener("backgroundfetchabort", (event) => {
// clean up any related data
});
Spezifikationen
| Spezifikation |
|---|
| Background Fetch # dom-serviceworkerglobalscope-onbackgroundfetchabort |