BackgroundFetchRegistration: failureReason 属性
注意:此功能在 Web 工作线程 中可用。
failureReason
是 BackgroundFetchRegistration
接口的只读属性,它返回一个字符串,该字符串的值表示后台获取失败的原因。
如果此属性的值发生变化,则会在关联的 BackgroundFetchRegistration
对象上触发 progress 事件。
值
以下字符串之一
""
-
后台获取尚未完成,或者已成功。
"aborted"
-
该操作被用户取消,或者调用了
abort()
。 "bad-status"
-
响应具有非 OK 状态(状态不在 200-299 范围内)。
"fetch-error"
-
获取因其他原因失败,例如 CORS 或网络故障。
"quota-exceeded"
-
操作过程中达到存储配额。
"download-total-exceeded"
-
提供的
downloadTotal
超过限制。此值在注册后台获取时设置。
示例
将此属性记录到控制台将打印获取失败的原因,或者如果成功或尚未完成则打印空字符串。
js
console.log(bgFetch.failureReason);
规范
规范 |
---|
后台获取 # dom-backgroundfetchregistration-failurereason |
浏览器兼容性
BCD 表仅在浏览器中加载