BackgroundFetchRegistration: failureReason-Eigenschaft

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.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die failureReason schreibgeschützte Eigenschaft des BackgroundFetchRegistration-Interfaces gibt einen String zurück, dessen Wert den Grund für ein Scheitern des Hintergrundabrufs angibt.

Wenn sich der Wert dieser Eigenschaft ändert, wird das progress-Ereignis auf dem zugehörigen BackgroundFetchRegistration-Objekt ausgelöst.

Wert

Einer der folgenden Strings:

""

Der Hintergrundabruf ist nicht abgeschlossen oder war erfolgreich.

"aborted"

Der Vorgang wurde vom Benutzer abgebrochen oder es wurde abort() aufgerufen.

"bad-status"

Eine Antwort hatte einen nicht-ok Status (einen Status außerhalb des Bereichs 200-299).

"fetch-error"

Ein Abruf scheiterte aus anderen Gründen, zum Beispiel CORS oder ein Netzwerkfehler.

"quota-exceeded"

Das Speicherlimit wurde während des Vorgangs erreicht.

"download-total-exceeded"

Das angegebene downloadTotal wurde überschritten. Dieser Wert wurde beim Registrieren des Hintergrundabrufs festgelegt.

Beispiele

Das Protokollieren dieser Eigenschaft in der Konsole gibt den Grund für das Scheitern des Abrufs zurück oder einen leeren String, wenn er erfolgreich war oder noch nicht abgeschlossen ist.

js
console.log(bgFetch.failureReason);

Spezifikationen

Specification
Background Fetch
# dom-backgroundfetchregistration-failurereason

Browser-Kompatibilität

BCD tables only load in the browser