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

浏览器兼容性