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 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 backgroundfetchfail Ereignis der ServiceWorkerGlobalScope Schnittstelle wird ausgelöst, wenn eine Background Fetch Operation fehlgeschlagen ist: das heißt, wenn mindestens eine Netzwerk-Anfrage im Fetch nicht erfolgreich abgeschlossen wurde.
Dieses Ereignis ist nicht abbruchfähig und wird nicht gebubbelt.
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 übergeordneten BackgroundFetchEvent.
BackgroundFetchUpdateUIEvent.updateUI()-
Aktualisiert die Benutzeroberfläche des Elements, das der Browser anzeigt, um den Fortschritt der Fetch-Operation darzustellen.
Beschreibung
Wenn eine Background Fetch Operation fehlschlägt (bedeutet, dass mindestens eine der einzelnen Netzwerk-Anfragen nicht erfolgreich abgeschlossen wurde), startet der Browser den Service Worker gegebenenfalls und löst das backgroundfetchfail Ereignis im globalen Bereich des Service Workers aus.
In der Background Fetch API zeigt der Browser der Benutzeroberfläche ein UI-Element an, um den Fortschritt der Operation anzuzeigen. Im backgroundfetchfail Handler kann der Service Worker diese Benutzeroberfläche aktualisieren, um anzuzeigen, dass die Operation fehlgeschlagen ist. Um dies zu tun, ruft der Handler die updateUI() Methode des Ereignisses auf und übergibt einen neuen Titel und/oder Symbole.
Im Handler für dieses backgroundfetchfail kann der Service Worker auch alle zugehörigen Daten der Operation bereinigen. Er kann auch erfolgreich empfangene 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
Aktualisierung der Benutzeroberfläche
Dieser Ereignishandler aktualisiert die Benutzeroberfläche, um dem Benutzer mitzuteilen, dass die Operation fehlgeschlagen ist.
addEventListener("backgroundfetchfail", (event) => {
event.updateUI({ title: "Could not complete download" });
});
Spezifikationen
| Specification |
|---|
| Background Fetch # dom-serviceworkerglobalscope-onbackgroundfetchfail |