ServiceWorkerGlobalScope: backgroundfetchabort 事件

有限可用性

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

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

安全上下文：此功能仅在 安全上下文（HTTPS）中可用，在某些或所有 支持浏览器 中可用。

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

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

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

语法

在像 addEventListener() 这样的方法中使用事件名称，或者设置事件处理程序属性。

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

onbackgroundfetchabort = (event) => {};

事件类型

一个 BackgroundFetchEvent。

Event ExtendableEvent BackgroundFetchEvent

事件属性

继承自父级 ExtendableEvent 的属性。

BackgroundFetchEvent.registration

返回已中止获取的 BackgroundFetchRegistration。

描述

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

如果获取被取消，浏览器将中止获取，必要时启动 service worker，并在 service worker 的全局范围内触发 backgroundfetchabort 事件。

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

示例

清理

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

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

规范

规范
后台获取
# dom-serviceworkerglobalscope-onbackgroundfetchabort

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅