BackgroundFetchRegistration: failureReason 属性

有限可用性

此功能不是基线,因为它在一些使用最广泛的浏览器中无法正常工作。

实验性: 这是一个 实验性技术
在生产环境中使用此功能之前,请仔细查看 浏览器兼容性表

注意:此功能在 Web 工作线程 中可用。

failureReasonBackgroundFetchRegistration 接口的只读属性,它返回一个字符串,该字符串的值表示后台获取失败的原因。

如果此属性的值发生变化,则会在关联的 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 表仅在浏览器中加载