BackgroundFetchRegistration.failureReason

利用可能性は限定的

この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。

Want more support for this feature? Tell us why.

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

failureReason は BackgroundFetchRegistration インターフェイスの読み取り専用プロパティで、バックグラウンドフェッチが失敗した理由を示す値を文字列で返します。

このプロパティの値が変化したとき、関連する BackgroundFetchRegistration オブジェクトで、progress イベントが発火します。

値

下記文字列のいずれかの値をとります。

"": バックグラウンドフェッチが完了していない、もしくは成功したとき。
"aborted": ユーザーによって操作がキャンセルされたとき、または abort() が呼び出されたとき。
"bad-status": 応答ステータスが OK ではないとき ( 200 ~ 299 の範囲外のとき)
"fetch-error": その他の理由によりフェッチが失敗したとき。例えば、CORS 違反や、ネットワーク障害が理由の場合です。
"quota-exceeded": 途中でストレージ容量の上限に達したとき。
"download-total-exceeded": バックグラウンドフェッチの登録時に指定された downloadTotal を超過したとき。

このプロパティをコンソールにログ出力すると、フェッチが失敗した理由が表示されます。フェッチが進行中または成功した場合は空文字列が表示されます。

console.log(bgFetch.failureReason);

仕様書
Background Fetch # dom-backgroundfetchregistration-failurereason

このページは MDN の貢献者によって 2022年11月18日に最終更新されました。