{
  "id": "service-worker",
  "title": "Service Worker",
  "lang": "zh-Hans",
  "source_lang": "en",
  "summary": "Service Worker 是由事件驱动的浏览器脚本，可介入网络请求，并为网页应用提供离线、缓存及部分后台功能。",
  "category": "computer-science",
  "subcategory": "software",
  "type": "concept",
  "aliases": [],
  "generated_at": "2026-11-05",
  "model": "pro/gpt-6.1-sol",
  "url": "https://aiwiki.page/zh/service-worker/",
  "translations": {
    "en": {
      "url": "https://aiwiki.page/en/service-worker/",
      "json": "https://aiwiki.page/en/service-worker.json"
    }
  },
  "sections": [
    {
      "heading": "",
      "text": "Service Worker 是由网页浏览器独立于网页运行的脚本，用于处理与网站或网页应用相关的事件。它最为人熟知的能力是拦截请求，并从网络、本地存储或应用自行定义的逻辑中提供响应。这使网站能够在没有网络连接时加载先前存储的内容，协调应用资源的更新，并在没有打开任何应用页面的情况下响应某些事件。\n\nService Worker 通常以 JavaScript 编写，在浏览器管理的安全与执行环境中运行。它们无法直接操作页面的文档，而且可能在事件之间停止执行。持续保留的是注册信息以及单独存储的应用数据，而不是一个持续运行的程序。因此，其设计将事件驱动的执行方式、显式存储机制与生命周期管理结合起来，并在生命周期中将新版本的安装与接管现有页面分开。\n\nService Worker 是渐进式网页应用的一项基础技术，但其用途并不限于已安装的应用，也不能仅凭自身就让网站具备可安装性或完整的离线功能。它们的实际行为取决于请求路由、缓存策略、存储可用性、浏览器支持情况以及应用各版本之间的协调。"
    },
    {
      "heading": "起源与标准化",
      "text": "Service Worker 的出现，是为了让 Web 应用在网络缓慢、不稳定或完全断网时也能更可靠地运行。早期的 Web 平台通常假定，页面导航会从服务器获取文档。尽管普通的浏览器缓存可以复用资源，但应用对于哪些资源应共同构成完整的离线体验，以及请求失败时应返回什么响应，控制能力都很有限。\n\n一个重要的前身是 应用缓存，通常称为 AppCache。它使用清单来指定供离线使用的资源，并提供了一些回退规则和网络选择规则。对于小型应用而言，这种声明式模型相对简单，但在更复杂的网站中，其更新行为以及与页面导航的相互影响却很难管理。AppCache 不提供通用的可编程请求处理机制。相比之下，Service Worker 在符合条件的请求与响应来源之间引入了明确的应用逻辑，从而可以针对文档、图像、应用数据及其他资源采用不同的策略。\n\nService Worker 的早期设计于 2013 年至 2014 年间逐步成形。Alex Russell 和 Jake Archibald 在设计及向开发者讲解这一技术方面作出了突出贡献。随后几年，各浏览器陆续部署了支持：Chrome 40 于 2015 年 1 月率先支持 Service Worker，Firefox 44 于 2016 年 1 月跟进，Safari 11.1 则在 2018 年加入支持。Microsoft Edge 也于 2018 年开始支持。这些里程碑针对的是核心机制；推送投递、后台同步和安装集成等相关功能则各有不同的实现进度。\n\n该规范通过 万维网联盟制定，并依赖其他多项 Web 平台标准。其请求拦截依赖 Fetch 处理模型，执行模型建立在 Worker 和 HTML 事件循环之上，资源的持久化存储则由 Cache API 提供。通知、推送消息和后台同步各自拥有独立的规范，并不是 Service Worker 的不同叫法。\n\n这种划分对于理解浏览器所宣称的支持范围十分重要。浏览器可能实现了注册、激活和 fetch 拦截，却未提供某个特定的后台 API。同样，应用也可以仅使用 Service Worker 来增强网络适应能力，而不提供推送通知。这项技术的核心是一个执行与拦截框架，而不是一项将所有能力捆绑在一起的应用功能。"
    },
    {
      "heading": "执行模型及其与网页的隔离",
      "text": "Service Worker 在 ServiceWorkerGlobalScope 中运行，而非页面的 Window 环境。它无法直接访问文档对象模型，因此不能通过调用常规文档方法来读取元素、修改样式表或更新界面。它与页面之间的通信采用 postMessage()、消息通道和 Clients 接口等机制。页面收到消息后，会在自己的执行环境中完成相应的界面更改。\n\n这种将后台脚本执行与页面脚本执行分离的方式，与其他 Web Worker 类似，但两者的归属模型不同。专用 Worker 通常由某个特定页面创建，用于处理该页面的任务。Service Worker 则归属于一个与存储上下文和 URL 作用域关联的注册项。它可以为多个符合条件的客户端服务，即使没有打开任何应用窗口，也可以启动并处理受支持的事件。“Worker”一词并不意味着应用控制着一个永久存在的操作系统线程。\n\n其执行以事件和异步编程为基础。浏览器会在需要时启动 Worker，求值执行其脚本，并分派 install、activate、fetch 或 push 等事件。JavaScript 处理函数通过事件循环运行，而网络和存储操作通常返回 Promise。因此，获取响应或读取缓存不必阻塞浏览器的其他活动，不过，CPU 密集型 JavaScript 仍可能延误 Worker 内部的其他工作。\n\n浏览器可能终止空闲的 Worker，之后再创建一个全新的执行环境来处理另一个事件。因此，全局变量不适合用作持久状态的权威来源。例如，用于记录待发送消息队列的变量，可能在下一个事件到来之前就已消失。需要持久保存的记录应存放在适当的存储系统中，例如 IndexedDB；处理函数也必须能够在恢复执行时重建自身状态。顶层事件监听器通常在脚本首次求值执行期间注册，以便浏览器能够按预期分派事件。\n\n有两种方法可将异步工作与事件处理关联起来。event.waitUntil(promise) 告知浏览器，某个可延长生命周期的事件有关联工作需要等待完成。在安装期间，Promise 被拒绝可能导致新 Worker 安装失败。对于 fetch 事件，event.respondWith() 用于提供代表响应的 Promise。这两种方法都不会赋予无限的运行时间：浏览器可以施加执行时限、中止工作，或在异常情况下终止执行。因此，这一模型更接近可重启的事件处理程序，而非持续运行的服务器或守护进程。"
    },
    {
      "heading": "注册、源与作用域",
      "text": "页面通常通过 navigator.serviceWorker.register() 注册 Service Worker。注册时需指定脚本 URL，也可以指定作用域。例如，一次简单的注册可以将 /sw.js 与 / 关联，使该注册能够控制同一源下的所有文档。针对同一作用域重复调用注册方法，通常会引用已有的注册，并可能触发更新检查；这并不意味着每次访问页面都会创建一个独立且永久存在的工作线程。\n\nService Worker 要求在安全上下文中运行。在常规部署中，这意味着使用由 传输层安全协议保护的 超文本传输安全协议。localhost 等开发环境会受到特殊处理，被视为潜在可信的源。之所以有这一要求，是因为请求拦截具有很大的权限：否则，在不安全传输过程中被替换的脚本就可能植入持久生效的行为，持续影响后续访问。\n\n工作线程脚本必须从注册页面的同一源获取。浏览器会检查脚本响应，包括其是否具有可接受的 JavaScript 媒体类型。作用域也受到限制。默认情况下，位于 /app/sw.js 的脚本可以注册的作用域为 /app/ 目录及其下级路径，但不能覆盖整个源。服务器可以通过 Service-Worker-Allowed 响应头明确允许更大的作用域。这可以防止放置在某个局部目录中的脚本自动取得对无关路径的控制权。\n\n作用域决定的是某个注册可以控制哪些客户端，而不只是其处理程序可以接收到哪些请求 URL。受控页面可以请求其他路径或其他源的资源；在 Fetch 模型和安全规则允许的情况下，这些请求可以在控制该页面的工作线程中触发 fetch 事件。反过来，位于工作线程作用域之外的页面，不会仅仅因为下载了 URL 位于该作用域内的图片，就受到该工作线程控制。当多个注册的作用域重叠时，为客户端选择注册要依据匹配范围最具体的作用域。\n\n注册工作线程通常也不会让当前页面立即受其控制。首次访问时，页面可能已经完成加载，而工作线程仍在后台安装和激活；之后的导航才可能使页面获得控制器。clients.claim() 允许已激活的工作线程接管符合条件的现有客户端，而 navigator.serviceWorker.controller 则用于获取页面当前的控制器。ready Promise 表明页面已有适用的注册，且该注册拥有已激活的工作线程，但这并不等于保证当前文档已经有控制器。"
    },
    {
      "heading": "安装、激活与版本替换",
      "text": "一个 Service Worker 注册项可以同时有处于安装中、等待中和活动状态的工作线程。这些是注册项中的不同角色，并非三个永久运行的进程。单个工作线程会经历 installing、installed、activating、activated 和 redundant 等状态。更新成功后，新版本通常会进入等待状态，而旧版本仍保持活动，为现有客户端提供服务。\n\ninstall 事件是准备某个版本所需资源的主要时机。应用可以打开一个特定版本的缓存，下载界面外壳、脚本以及离线错误页面。将这一操作传给 event.waitUntil()，就意味着只有该操作成功完成，安装才算成功。如果必要资源下载失败，且相应的 Promise 被拒绝，安装就会失败。此时，现有的活动工作线程可以继续提供服务，而不会被缺少必要资源的新版本取代。\n\n新安装的工作线程通常会等待，直到使用先前活动工作线程的客户端不再需要它。这样可以避免按某一应用版本加载的页面，意外收到按照另一版本的逻辑生成的响应。因此，多个标签页可能会使旧工作线程持续处于活动状态。重新加载某个标签页并不一定会移除所有旧客户端，所以即使重新加载后，开发者工具中仍可能显示有更新正在等待。\n\n等待中的工作线程可以调用 skipWaiting()，请求提前激活。随后，正在激活的工作线程可以使用 clients.claim()，接管符合条件的客户端。这是两项不同的操作：跳过等待阶段改变的是工作线程何时进入活动状态，而接管客户端改变的是现有合格客户端的控制者。同时使用这两项操作可以让更新迅速生效，但也可能使旧页面的 JavaScript 与新的请求路由逻辑混用。对于要求各部分版本严格匹配的应用，通常会改为协调执行一次明确的页面重新加载。\n\nactivate 事件提供了执行迁移和清理工作的时机，例如移除过时的应用缓存。传给该事件 waitUntil() 的任务，可以推迟功能性事件的处理，直到激活工作完成。清理时必须考虑共享存储空间的客户端和其他注册项；缓存名称不会按注册作用域自动隔离。\n\n浏览器会在规定的注册和导航活动期间检查工作线程脚本是否有更新，应用也可以通过 registration.update() 主动请求检查。更新依据的是脚本的字节内容，而不是开发者指定的版本号。updateViaCache 选项会影响更新检查期间对浏览器 HTTP 缓存的使用。保持注册 URL 不变，可以让生命周期机制负责替换工作线程；而带版本号的缓存名称或资源哈希，则用于区分它所管理的资源。"
    },
    {
      "heading": "Fetch 拦截与请求—响应语义",
      "text": "Service Worker 的核心能力是参与浏览器的 Fetch API 处理流程。当符合条件的请求触发 fetch 事件时，事件处理函数会收到一个 Request，并且可以提供一个 Response。文档导航、图像、样式表、脚本以及页面 JavaScript 发起的请求都可能触发这一过程。拦截请求并不意味着必须替换每个响应：处理函数可以不对事件作出响应，让常规网络处理继续进行。\n\n要接管请求，处理函数需要在事件分派期间调用 event.respondWith()，通常传入一个稍后兑现为响应的 Promise。这个 Promise 可以从服务器获取资源、查找缓存、构造新响应，或组合执行多项操作。如果传入的 Promise 被拒绝，或兑现为不符合要求的响应，请求就会失败，而不会自动回退到网络。回退行为必须由处理函数的逻辑明确实现。\n\n请求体和响应体通常采用只能消费一次的流。如果既要将网络响应返回给页面，又要将其写入缓存，处理函数通常会在其中一个使用方读取响应体之前克隆该响应。同样，如果请求还要继续转发，那么为记录日志或加入队列而读取请求体时也需要谨慎。克隆会创建另一个可读分支，并不意味着可以不受限制、毫无开销地复制：当各分支的消费速度不同时，缓冲和背压可能会影响内存使用量。\n\n安全限制仍然适用。跨源资源共享 决定脚本何时可以访问跨源响应的内容。以 no-cors 模式发起的跨源请求可能产生不透明响应，Service Worker 无法检查其响应体和响应头。这类响应可用于图像等资源，也可以通过适当的 Cache API 操作存储，但其不透明性会增加验证和错误检测的难度。\n\n网络故障与表示请求未成功的 HTTP 状态码是两种不同情况。服务器返回状态码为 404 或 500 的响应时，fetch Promise 通常仍会兑现为一个响应；连接失败则通常会使其被拒绝。因此，如果离线回退机制只处理被拒绝的 Promise，就不会自动替换服务器错误响应。当处理策略取决于 HTTP 请求是否成功时，处理函数必须检查状态码或 response.ok。\n\n导航还有一项专门用于提升性能的功能，称为导航预加载。启用后，浏览器可以在启动 Service Worker 的同时开始发送导航请求。处理函数可以使用 event.preloadResponse，而不必重复发起 fetch 请求。这能减少以网络为主的导航策略中的启动延迟，但需要有意识地协调缓存和响应选择逻辑。"
    },
    {
      "heading": "缓存存储与离线响应策略",
      "text": "缓存 API 提供了显式存储请求与响应对的机制。通过 caches 访问的 CacheStorage 用于管理具名缓存；每个 Cache 都提供 match()、put() 和 delete() 等操作。这种存储独立于浏览器常规的 超文本传输协议（HTTP）缓存。尤其需要注意的是，通过缓存 API 显式存储的条目不会按照 HTTP 新鲜度指令自动过期。何时复用、替换或删除这些条目，由应用代码决定。\n\n缓存匹配并非简单地根据字符串查找文件，而是有更复杂的规则。请求 URL、请求方法以及响应中的 Vary 首部都可能影响匹配，查询字符串通常也会用于区分条目。忽略查询字符串可以避免某些跟踪参数影响缓存复用，但也可能混淆实际不同的资源。缓存 API 的存储操作面向 GET 请求；若要保存任意 POST 操作以便稍后重放，通常需要将其数据存储在其他地方，而不能将其当作普通的缓存响应处理。\n\n几种常见策略体现了不同的取舍：\n\n- 缓存优先：返回匹配的已存储响应，找不到匹配项时再使用网络。适用于采用版本化 URL、且同一 URL 下内容保持不变的资源。\n- 网络优先：先尝试从网络获取响应，在失败或达到指定超时时间后回退到本地存储。既优先提供最新内容，也保留离线访问途径。\n- 先用旧缓存，同时重新验证：立即返回已存储的响应，同时获取替代响应，供后续请求使用。必须通过 waitUntil() 使这一后台更新始终与事件保持关联。\n- 仅网络和仅缓存：有意只使用单一来源，适用于某些敏感请求或预先打包的资源。\n\n预缓存和运行时缓存针对不同的资源集合。预缓存在安装期间存储选定的资源，通常使用构建时生成、包含内容修订信息的清单。运行时缓存则在请求发生时添加资源。例如，离线应用可以预缓存其导航外壳，并在运行时缓存最近浏览过的文章。仅仅存储脚本和样式，并不能保留服务器端搜索结果、身份验证状态或用户从未下载过的数据。\n\n存储空间有限，且由浏览器管理。配额因浏览器和运行环境而异，写入可能失败，数据也可能在存储空间紧张时被清除。在支持持久存储权限的环境中，该权限可以改变浏览器清除数据的处理方式，但无法防止用户删除数据，也不能规避所有浏览器策略。因此，对于响应、IndexedDB 记录和应用偏好设置，都需要处理本地状态缺失或仅部分可用的情况。\n\n缓存设计也会影响隐私。缓存名称并不能作为用户授权的边界。除非应用明确协调缓存的删除与使用，否则个性化响应可能在用户退出登录或切换账户后仍然保留。缓存规则必须区分公共且内容不变的资源与特定账户的数据；而 Cache-Control: no-store 这样的响应首部，本身并不能阻止应用代码显式地将响应放入缓存存储。"
    },
    {
      "heading": "推送消息与延后执行的后台任务",
      "text": "Service Worker 为多种无需打开应用页面即可运行的功能提供了事件目标。其中最广为人知的是 Web 推送，它将浏览器管理的订阅、推送服务、应用服务器和 Push API 结合起来。订阅会向应用服务器提供必要的信息，使其能够向该浏览器订阅发送消息并对消息加密。推送消息到达时，浏览器可以启动 Service Worker，并派发一个 push 事件。\n\n推送消息的投递和通知的显示是两个不同的操作。推送消息可以携带供工作线程使用的数据，而 registration.showNotification() 则请求浏览器或操作系统向用户显示通知。用户随后与通知交互时，可以触发 notificationclick 事件，让工作线程将焦点切换到已有的应用窗口，或打开相应的 URL。这些操作仍受权限、浏览器策略及特定平台限制的约束。\n\n推送并不是一种可用于静默持续计算的可靠通用通道。浏览器可以要求推送产生用户可见的效果、限制滥用行为，并根据网络连接状况或操作系统的行为延迟投递。订阅可能过期或失效，应用服务器必须处理投递失败的情况。因此，推送消息通常用作获取最新状态的信号，而不是某项事务唯一的权威记录。\n\n后台同步 API 解决的是另一个问题：在网络连接条件合适时，重试先前延后的任务。页面可以先在本地存储计划执行的操作，再注册一个同步标签。浏览器随后会派发 sync 事件，由工作线程尝试执行任务。如果与该事件关联的 Promise 被拒绝，浏览器可能会根据自身的实现重试。各浏览器的支持情况和调度方式有所不同，因此，注册同步任务并不意味着它一定会在指定时间执行。\n\n需要持久保存的后台操作必须使用显式队列，通常存放在 IndexedDB 中。以离线提交表单为例：应用先存储待发送的数据和操作标识符，然后在合适的事件中尝试发送。如果服务器接受了该操作，但工作线程在记录成功状态之前停止，后续尝试就可能再次发送同一操作。通过服务器端去重或将操作设计为幂等，可以避免产生重复效果。后台同步并不能保证恰好一次投递，也不会创建横跨本地存储和远程服务器的数据库事务。\n\n周期性后台同步是一项独立的功能，支持范围更窄，其运行由浏览器决定，而不是由精确定时器控制。普通的 setTimeout() 和 setInterval() 调用无法替代它，因为工作线程可能在空闲时停止。最好将这些后台功能理解为受限的调度机会；应用能否正确运行，仍取决于持久化状态和恢复逻辑。"
    },
    {
      "heading": "安全、隐私与信任边界",
      "text": "Service Worker 的强大之处在于，它能影响受其控制的页面接收到的内容，包括导航所加载的文档和可执行资源。如果攻击者能够在有利用价值的作用域下注册恶意 Service Worker，其影响就可能在后续访问中持续存在，直到该注册被替换或移除。因此，Service Worker 的部署属于网站的网络安全边界，而不仅仅是一项性能配置。\n\nHTTPS 可以保护获取 Service Worker 及其受控资源时所使用的传输通道，但并不能证明应用代码值得信任。遭到入侵的部署流水线、提供恶意脚本的同源端点，或能力足够强的跨站脚本攻击，仍然可能破坏注册过程的安全性。注册时的同源限制和作用域限制可以约束权限，但如果某个源已经在提供由攻击者控制的可执行代码，这些限制也无法弥补这一问题。\n\n内容安全策略可以限制 Service Worker 的创建和资源加载。适用于页面的策略可以限制页面能够注册哪些来源的 Worker，而随 Worker 脚本一同返回的策略则约束该 Worker 环境中的相关行为。这些控制措施与服务器端对脚本托管的限制以及合理的作用域边界相辅相成。但即便如此，仍须将 Worker 代码视为具有较强持久性和请求拦截权限的可信应用代码。\n\nService Worker 仍然受浏览器安全模型的约束。它不能随意读取本地文件、控制其他源，或绕过跨源响应限制。带有 HttpOnly 属性的 HTTP Cookie 不会以可读的 Cookie 值形式暴露给 Worker 中的 JavaScript，但符合条件的请求仍可根据其凭据模式和 Cookie 规则携带凭据。读取凭据与发起经过身份验证的请求是两回事，这一区别十分重要：无法直接访问 Cookie，并不意味着拦截请求就没有风险。\n\n隐私保护措施也会影响持久化机制。浏览器可能根据嵌入上下文对存储进行分区，限制第三方注册，或在隐私浏览模式下应用特殊规则。注册的作用域并不是一种通用的跨站身份标识。应用不能假定，只要其源出现在某个上下文中，就能共享同一份注册及其缓存。\n\n最后，注销 Service Worker 与删除应用存储是两项独立的操作。unregister() 会移除注册，但不会自动清除命名缓存或 IndexedDB 数据库；已经受其控制的客户端也可能继续受到影响，直到它们与该 Worker 的控制关系结束。因此，在开展安全恢复和移除用户数据时，需要分别处理注册、已打开的页面、已存储的响应以及持久化的应用记录等不同状态。"
    },
    {
      "heading": "应用架构、测试与运行限制",
      "text": "Service Worker 在页面导航和服务器部署之外，引入了另一套应用生命周期。页面、控制该页面的 Worker、缓存资源、本地数据库和服务器可能各自对应应用的不同版本。因此，兼容性成为一个核心的软件工程问题。如果一次部署立即删除所有旧脚本，那么仍处于打开状态的页面稍后请求其中某个脚本时，就可能无法正常工作，即使新版 Worker 与新版页面能够正常配合也不例外。\n\n为资源添加版本标识，并明确划分缓存命名空间，有助于管理这一问题。包含内容哈希的文件名能让不可变资源的多个版本并存，而固定的 Worker URL 则能让浏览器发现更新。Worker 可以保留旧版客户端所需的资源，也可以在删除资源之前协调迁移。本地数据库的模式变更也需要同样谨慎：否则，新激活的 Worker 与旧版页面可能对记录结构、队列格式或事务行为产生不同的预期。\n\n请求处理也类似于一个小型的分布式计算系统。网络是否可用并不确定，本地写入与远程提交是两个独立操作，而且多个标签页可能并发操作共享数据。当两个客户端同时更新一个队列，或根据过时的缓存响应推断状态时，就可能出现竞态条件。IndexedDB 事务、操作标识符、明确的消息协议和服务器端冲突处理，分别应对这一问题的不同方面；没有哪一种缓存策略能解决所有问题。\n\n开发工具可以显示注册信息、生命周期状态、受控客户端、缓存以及 Worker 执行日志。有效的测试应区分首次访问与再次访问、已完全终止的 Worker 与因调试而保持运行的 Worker，以及单个标签页与使用不同版本的多个标签页。其他重要测试场景还包括安装失败、存储配额耗尽、账号切换、推送权限被拒绝、上传中断，以及服务器返回错误响应而非连接失败的情况。\n\n仅模拟离线状态并不足够。请求可能因网络信号较弱而一直挂起，而不是迅速失败；强制门户可能返回意料之外的内容；浏览器也可能在两次访问之间清除存储数据。因此，测试还应涵盖慢速网络、响应中断、缓存资源不可用，以及在队列处理的各个步骤之间重启的情况。开发工具本身也可能通过强制更新、绕过请求拦截或改变 Worker 的存活时间来影响行为，因此必须将这些设置下的行为与正常运行时的行为区分开来。\n\nService Worker 可以提升重复加载的性能，但也可能增加启动延迟、造成重复的网络请求，或保留不必要的数据。性能测量应区分冷缓存与热缓存、受控访问与非受控访问，以及 Worker 启动耗时与请求处理耗时。Workbox 等库提供了预缓存和路由抽象，但其生成的规则仍受相同的生命周期与存储限制约束。对于没有适用 Worker 的浏览器、已清除存储数据的用户，以及首次访问的用户，应用仍需依靠常规的网络交付方式运行。"
    }
  ],
  "links": [
    "web-browser",
    "javascript",
    "world-wide-web-consortium",
    "asynchronous-programming",
    "event-loop",
    "transport-layer-security",
    "https",
    "hypertext-transfer-protocol",
    "database-transaction",
    "cybersecurity",
    "http-cookie",
    "software-engineering",
    "distributed-computing",
    "race-condition"
  ],
  "sources": [],
  "license": "https://creativecommons.org/licenses/by/4.0/"
}