NavigationPreloadManager: disable() 方法

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

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

disable() 方法是 NavigationPreloadManager 接口的方法，它会停止先前使用 enable() 启动的服务工作者管理资源的自动预加载。它返回一个解析为 undefined 的 Promise。

此方法可以在服务工作者的 activate 事件处理程序中调用（在 fetch 事件处理程序可以被调用之前）。

语法

js
disable()

参数

无。

返回值

一个解析为 undefined 的 Promise。

异常

InvalidStateError DOMException

没有与此 NavigationPreloadManager 所属的注册关联的活动工作者。

示例

以下代码演示了如何在首次使用 ServiceWorkerRegistration.navigationPreload 测试其支持性后禁用预加载。

js
addEventListener("activate", (event) => {
  event.waitUntil(
    (async () => {
      if (self.registration.navigationPreload) {
        // Disable navigation preloads!
        await self.registration.navigationPreload.disable();
      }
    })(),
  );
});

规范

规范
服务工作者
# dom-navigationpreloadmanager-disable

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅

NavigationPreloadManager.enable()