ServiceWorkerRegistration: updateViaCache 属性

安全上下文:此功能仅在安全上下文(HTTPS)中,在某些或所有支持的浏览器中可用。

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

updateViaCacheServiceWorkerRegistration 接口的只读属性,它返回用于确定浏览器在尝试更新服务工作者或任何通过 importScripts() 导入的脚本时,是否会查询 HTTP 缓存的设置值。

返回以下值之一

  • imports,表示不会查询 HTTP 缓存以更新服务工作者脚本,但会查询使用 importScripts() 导入的脚本。这是默认值。
  • all,表示会查询 HTTP 缓存以更新服务工作者脚本以及使用 importScripts() 导入的脚本。
  • none,表示永远不会查询 HTTP 缓存。

示例

以下示例展示了 updateViaCache 的使用方式。

js
if ("serviceWorker" in navigator) {
  navigator.serviceWorker
    .register("/service-worker.js", {
      updateViaCache: "none",
    })
    .then((registration) => {
      registration.addEventListener("updatefound", () => {
        // If updatefound is fired, it means that there's
        // a new service worker being installed.
        console.log(`Value of updateViaCache: ${registration.updateViaCache}`);
      });
    })
    .catch((error) => {
      console.error(`Service worker registration failed: ${error}`);
    });
}

规范

规范
Service Workers
# service-worker-registration-updateviacache

浏览器兼容性

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

另请参见