ServiceWorkerGlobalScope：backgroundfetchabort 事件

可用性有限

此特性不是基线特性，因为它在一些最广泛使用的浏览器中不起作用。

实验性： 这是一项实验性技术
在生产中使用此技术之前，请仔细检查浏览器兼容性表格。

安全上下文： 此功能仅在安全上下文（HTTPS）中可用，且支持此功能的浏览器数量有限。

注意：此功能仅在 Service Workers 中可用。

backgroundfetchabort 事件是 ServiceWorkerGlobalScope 接口的一个事件，当用户或应用程序本身取消后台获取操作时触发。

此事件不可取消，也不会冒泡。

语法

在诸如 addEventListener() 之类的方法中使用事件名称，或设置事件处理程序属性。

addEventListener("backgroundfetchabort", (event) => { })

onbackgroundfetchabort = (event) => { }

继承自其父级 ExtendableEvent 的属性。

BackgroundFetchEvent.registration: 返回被中止获取的 BackgroundFetchRegistration。

在后台获取 API 中，浏览器会向用户显示一个 UI 元素来指示操作的进度。该元素也允许用户取消获取。应用程序本身也可以通过调用 BackgroundFetchRegistration.abort() 来取消获取。

如果获取被取消，浏览器将中止该获取，并在必要时启动 Service Worker，然后在 Service Worker 的全局作用域中触发 backgroundfetchabort 事件。

在此事件的处理程序中，Service Worker 可以清理与该操作相关的任何数据。它还可以检索和存储任何成功的响应（例如，使用 Cache API）。要访问响应数据，Service Worker 使用事件的 registration 属性。

此事件处理程序可能会执行与被中止获取相关的任何数据清理。

addEventListener("backgroundfetchabort", (event) => {
  // clean up any related data
});

规范
Background Fetch # dom-serviceworkerglobalscope-onbackgroundfetchabort

此页面最后修改于 ⁨2025 年 5 月 2 日⁩，由 MDN 贡献者编辑。