BackgroundFetchRegistration: failureReason 屬性

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

注意:此功能在 Web Workers 中可用。

BackgroundFetchRegistration 介面的只讀屬性 failureReason 返回一個字串,其值表示後臺獲取失敗的原因。

如果此屬性的值發生更改,則會在關聯的 BackgroundFetchRegistration 物件上觸發 progress 事件。

以下字串之一

""

後臺獲取尚未完成,或者已成功。

"aborted"

操作被使用者取消,或者呼叫了 abort()

"bad-status"

響應的狀態碼不是 200-299 範圍內的(即狀態碼“不 OK”)。

"fetch-error"

獲取因其他原因失敗,例如 CORS 或網路故障。

"quota-exceeded"

操作期間達到了儲存配額。

"download-total-exceeded"

超出了提供的 downloadTotal。該值在註冊後臺獲取時設定。

示例

將此屬性記錄到控制檯會打印出獲取失敗的原因,如果獲取成功或尚未完成,則列印空字串。

js
console.log(bgFetch.failureReason);

規範

規範
Background Fetch
# dom-backgroundfetchregistration-failurereason

瀏覽器相容性