ServiceWorkerGlobalScope: backgroundfetchfail 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 backgroundfetchfail Ereignis des ServiceWorkerGlobalScope Interfaces wird ausgelöst, wenn ein Background Fetch Vorgang fehlgeschlagen ist, das heißt, wenn mindestens eine Netzwerk-Anfrage im Fetch nicht erfolgreich abgeschlossen wurde.
Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergeleitet.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.
addEventListener("backgroundfetchfail", (event) => {});
onbackgroundfetchfail = (event) => {};
Ereignistyp
Ereigniseigenschaften
Erbt Eigenschaften von seinem Elternteil, BackgroundFetchEvent.
BackgroundFetchUpdateUIEvent.updateUI()-
Aktualisiert die Benutzeroberfläche des Elements, das der Browser anzeigt, um den Fortschritt des Fetch-Vorgangs zu zeigen.
Beschreibung
Wenn ein Background Fetch Vorgang fehlschlägt (was bedeutet, dass mindestens eine der einzelnen Netzwerk-Anfragen nicht erfolgreich abgeschlossen wurde), startet der Browser bei Bedarf den Service Worker und löst das backgroundfetchfail Ereignis im globalen Bereich des Service Workers aus.
Im Background Fetch API zeigt der Browser ein UI-Element an, um dem Benutzer den Fortschritt der Operation anzuzeigen. Im backgroundfetchfail Handler kann der Service Worker diese UI aktualisieren, um anzuzeigen, dass der Vorgang fehlgeschlagen ist. Dafür ruft der Handler die updateUI() Methode des Ereignisses auf und übergibt einen neuen Titel und/oder Icons.
Im Handler für dieses backgroundfetchfail kann der Service Worker auch alle zugehörigen Daten für den Vorgang 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
UI Aktualisierung
Dieser Ereignishandler aktualisiert die Benutzeroberfläche, um den Benutzer darüber zu informieren, dass der Vorgang fehlgeschlagen ist.
addEventListener("backgroundfetchfail", (event) => {
event.updateUI({ title: "Could not complete download" });
});
Spezifikationen
| Specification |
|---|
| Background Fetch # dom-serviceworkerglobalscope-onbackgroundfetchfail |
Browser-Kompatibilität
BCD tables only load in the browser