检查 · Service Worker 回归

配置方法见交付与缓存。本文用于修改 SW 实现后的检查,不重复配置表与命令参数。

源码入口

位置(相对 module/)职责
layouts/_partials/system-delivery/pwa/配置、离线页和程序资源装配
assets/js/pwa/worker-enable.js.tmpl缓存、程序生命周期和站点构建版本
assets/js/pwa/manager-entry.js.tmpl普通页面注册
assets/js/site-status/Powered by 的程序与内容检查
assets/js/pwa/worker-disable.js、manager-disable.js停用与清理
assets/js/pwa/cache-names.js受管缓存名称

页面与程序更新

普通页面加载完成后注册,预渲染页面在激活后注册。浏览器负责正常程序更新与激活;页面链接、刷新、历史导航和检查按钮不能提前激活 waiting 程序,也不能自动重载页面。

检查首次安装、存在活动程序时的更新、等待期间的内容更新,以及停用后重新启用。首次安装须取得有效站点构建版本和默认语言离线页;后续更新须保留有效离线回退。安装与激活期间的暂存处理以 worker 源码及生命周期测试为准。

站点构建版本

站点构建版本与 SW 程序版本分别变化。只改内容版本时,sw.js 字节应保持不变。版本 JSON 须与内容一同部署;手动设置 params.build.version 时,每次内容发布都要更新它。

达到检查间隔后的首次受管导航应启动后台检查,不等待导航成功,不阻塞导航响应;并发导航共用一次请求。失败时保留原版本。waiting 程序存在时,活动程序仍可检查内容。

发现新构建版本后,后续请求使用新缓存;已打开页面保持原状。版本切换清理旧版本缓存,保留指纹缓存。旧请求完成时不能重新创建已删除的缓存。

缓存契约

缓存与 HTTP 响应头分别配置。版本缓存未命中时重新验证 HTTP 缓存,避免旧 HTML 写入新版本缓存。sw.js 与 sw-version.json 不进入页面或资源缓存桶。

首次访问尚未受 SW 控制,页面不追加缓存预热。受控导航缓存 HTML 并预热同源指纹资源。检查已缓存页面离线访问,以及未缓存页面的语言回退。

disable 模式

disable 使用独立的清理程序注销本站 SW,删除受管缓存,保留无关缓存。off 不执行清理。正常更新不能调用停用流程。

自动化场景

对已启用 SW 的生产构建运行代表检查;停用另行提供启用与停用两份实际构建:

swban check/browser/site <build> --updates                  #检查代表页面与 SW 更新
swban check/browser/pwa/disable <enabled> --next <disabled>  #检查停用
swban check/http/security <url>                             #部署后检查响应头

准备方式、单项任务、页面要求和报告范围统一见 Skill 的浏览器检查。两个实际代码版本的比较应使用实际构建对;临时生成的更新构建只用于检查更新机制。

源码回归入口见 tests/README.md 中的 PWA、内容更新与停用测试。报告失败项和跳过项,不把代表页面检查视为全部场景覆盖。

横向滚动 · 单击或按 Esc 退出