ServiceWorkerGlobalScope: backgroundfetchfail 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 backgroundfetchfail Ereignis der ServiceWorkerGlobalScope Schnittstelle wird ausgelöst, wenn ein Hintergrund-Abruf fehlgeschlagen ist: Das bedeutet, dass mindestens eine Netzwerkanforderung im Abruf nicht erfolgreich abgeschlossen wurde.
Dieses Ereignis ist nicht abbruchfähig und blubbert nicht.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("backgroundfetchfail", (event) => { })
onbackgroundfetchfail = (event) => { }
Ereignistyp
Beschreibung
Wenn ein Hintergrund-Abruf fehlschlägt (was bedeutet, dass mindestens eine der einzelnen Netzwerkanfragen nicht erfolgreich abgeschlossen wurde), startet der Browser den Service Worker, falls nötig, und löst das backgroundfetchfail Ereignis im globalen Bereich des Service Workers aus.
In der Hintergrund-Abruf-API zeigt der Browser dem Benutzer ein UI-Element an, um den Fortschritt der Operation anzuzeigen. Im backgroundfetchfail-Handler kann der Service Worker dieses UI-Element aktualisieren, um zu zeigen, dass die Operation fehlgeschlagen ist. Dazu 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 für die Operation bereinigen. Er kann auch erfolgreiche Antworten abrufen und speichern (zum Beispiel durch Verwendung der Cache API). Um auf die Antwortdaten zuzugreifen, verwendet der Service Worker die registration Eigenschaft des Ereignisses.
Beispiele
Aktualisierung der Benutzeroberfläche
Dieser Ereignis-Handler aktualisiert die Benutzeroberfläche, um dem Benutzer mitzuteilen, dass die Operation fehlgeschlagen ist.
addEventListener("backgroundfetchfail", (event) => {
event.updateUI({ title: "Could not complete download" });
});
Spezifikationen
| Spezifikation |
|---|
| Background Fetch # dom-serviceworkerglobalscope-onbackgroundfetchfail |