此页面由 Cloud Translation API 翻译。

使用 Service Worker Static Routing API 为特定路径绕过 Service Worker

Rachel Andrew

从 Chrome 123 开始，Service Worker 静态转送 API 可供使用。借助此 API，您可以声明性地声明应如何提取特定资源路径，这意味着浏览器无需仅为了从缓存或直接从网络提取响应而运行 Service Worker。此 API 自 Chrome 116 起就处于源试用阶段，本文详细介绍了将在 Chrome 123 中发布的 API。

使用 API

如需使用该 API，请对服务工件 install 事件调用 event.addRoutes。向此方法传递路线列表，其中包含以下属性：

condition

指定规则的应用时间。接受以下属性：

urlPattern：一个 URLPattern 实例，或表示有效网址Pattern 的字符串，可传递给 URLPattern 构造函数。
requestMethod：包含请求方法的字符串。
requestMode：包含请求模式的字符串。
requestDestination：包含请求目的地的字符串。
runningStatus：一个字符串，即 "running" 或 "not-running"。这表示服务工作线程的运行状态。

source

指定如何加载与 condition 匹配的资源。以下字符串之一：

"network"
"cache"
"fetch-event"
"race-network-and-fetch-handler"

在以下示例中，如果服务工作器当前正在运行，则以“/articles”开头的网址会被路由到该服务工作器。如果存在多个条件（例如 urlPattern 和 runningStatus），则必须满足所有条件才能使用相应路由。

addEventListener('install', (event) => {
  event.addRoutes({
    condition: {

          urlPattern: "/articles/*",
          runningStatus: "running"
    },
    source: "fetch-event"
  });
});

在以下示例中，对表单的发布会直接发送到网络，而绕过服务工件。

addEventListener('install', (event) => {
  event.addRoutes({
    condition: {
          urlPattern: "/form/*",
          requestMethod: "post"
    },
    source: "network"
  });
});

在以下示例中，名为 "pictures" 的缓存存储空间用于提取文件扩展名为 .png 或 .jpg 的文件。

addEventListener('install', (event) => {
  event.addRoutes({
    condition: {
      or: [
        {urlPattern: "*.png"},
        {urlPattern: "*.jpg"}
      ]
    },
    source: {
      cacheName: "pictures"
    }
  });
});

与源代码试用版相比的变化

原始来源试用版使用的是 InstallEvent.registerRouter()，而不是 InstallEvent.addRoutes()，因此 registerRouter() 方法只能调用一次。这项变更是根据社区对原始试行版的反馈做出的。

新 API 还利用了 Chrome 121 中引入的 URLPattern 变更，增加了指定请求方法、模式和目的地的功能，并添加了其他来源选项。

Chrome DevTools 中的支持

已注册的路由器规则会显示在应用面板的服务工作线程标签页中。

“应用”面板中突出显示的路由器规则。

在 Network 面板中，如果请求与已注册的规则匹配，则大小列中会显示相应信息。将指针悬停在“大小”列上时，系统会显示已注册的路由器 ID。相应的规则会显示在“应用”标签页中。

“网络”面板中显示的路由器 ID。