跳转到内容

测试 PWA

发布于 更新于

Chrome DevTools 可以检查页面为什么能安装或不能安装,控制 Service Worker 从 install 到 waiting 再到 activation 的过程。你也可以不拔网线就模拟离线,并在 Android 真机上确认安装流程。这些检查大多用 Application 面板,安装和生命周期消息则在 Console 抽屉查看。Lighthouse 的 PWA 类目已弃用。

先用 HTTPS 或 localhost 提供应用,再打开 Chrome DevTools。真机安装还需要一台开启 USB 调试的 Android 手机。控件名称使用 DevTools 的英文界面标签。

这些 DevTools 步骤使用 Chrome。Chrome 的远程调试指南列出了 Windows、macOS 和 Linux 桌面主机连接 Android Chrome 的方法;Device Mode 无法复现移动设备安装流程。注册检测使用 Service Worker API。兼容性数据记录了 Chrome 40、Edge 17、Firefox 44、macOS Safari 11.1、iOS Safari 11.3、Samsung Internet 4.0 和 Android WebView 40 起的支持情况(BCD api.ServiceWorker)。

1. 读 manifest 与它的 Installability 小节

链接到“1. 读 manifest 与它的 Installability 小节”一节

打开 DevTools,选择 Application,再选 Manifest。Identity 与 Presentation 小节以可读形式 显示 manifest 字段,Icons 列出每个声明的图标(Show only the minimum safe area for maskable icons 复选框预览裁切后的安全区),随后是 Shortcut #N 与 Screenshot #N 小节。图标加载失败或缺少必需字段时, 会出现一个 Installability 小节给出原因。点击地址栏的 Install 按钮时保持 Console 抽屉打开: 它会记录 manifest 问题与安装生命周期。

能通过的 manifest 至少包含以下字段。

{
"name": "Example PWA",
"short_name": "Example",
"start_url": "/",
"scope": "/",
"display": "standalone",
"icons": [
{ "src": "/icon-192.png", "sizes": "192x192", "type": "image/png" },
{ "src": "/icon-512.png", "sizes": "512x512", "type": "image/png" }
]
}

完整条件见可安装性条件:PWA 如何才能被安装。

2. 从 Service workers 面板驱动 worker

链接到“2. 从 Service workers 面板驱动 worker”一节

Application > Service workers 列出当前页面的注册,其中有 Source 和 Status 行,还列出了 Clients。 用这些控件测试 worker:

  • Offline 让 DevTools 进入离线模式,与 Network 面板的 Offline 节流预设相同。勾选后重新加载, 就能看到 worker 在没有网络时提供什么。
  • Update on reload 会在每次加载页面时强制更新 Service Worker。编辑 sw.js 时可以打开它,测试正常更新生命周期前再关掉。
  • Bypass for network 把请求直接送到网络,用来判断 bug 在 worker 里还是在页面里。
  • Push 模拟一次不带载荷的推送通知,Sync 模拟后台同步事件。
  • stop 停止正在运行的 worker;下一个事件会以全新的全局状态启动它,能暴露出假定内存变量会一直存在的代码。
  • Unregister 移除注册;Update 执行一次性的更新检查。

Update Cycle 表格显示 worker 的各项活动及耗时,例如 install 和 wait,以及之后的 activate;Expand 按钮展开 精确时间戳。

假定 navigator.serviceWorker 存在的测试脚手架在没有该 API 的浏览器里会抛错,而对应 scope 下没有注册时 getRegistration() 解析为 undefined。两者都检查,脚手架就会给出原因而不是一串堆栈。

export async function serviceWorkerState() {
if (!('serviceWorker' in navigator)) {
return { ok: false, reason: 'Service workers are not supported in this browser.' };
}
const registration = await navigator.serviceWorker.getRegistration();
if (!registration) {
return { ok: false, reason: 'No service worker is registered for this page yet.' };
}
const worker = registration.active || registration.waiting || registration.installing;
return { ok: true, state: worker ? worker.state : 'unknown', scope: registration.scope };
}

在 Console 里运行:(await serviceWorkerState()).state 在 worker 完成激活后打印 activated,在此之前可能打印 installing 或 installed,也可能是 activating。 需要确认失败原因时,运行整个函数。当前文档没有匹配的注册时,命令返回回退对象,不会从 undefined 读取 .active:

await serviceWorkerState()
// { ok: false, reason: 'No service worker is registered for this page yet.' }

注册并激活后,同一个命令会返回 ok 为 true 的对象;state 为 activated,scope 取自注册。MDN 说明,没有匹配的注册时,getRegistration() 会解析为 undefined。

Chrome 的 PWA 调试指南说明,Device Mode 无法模拟移动设备安装流程。用 USB 连接 Android 手机,开启 USB 调试,再在桌面端打开 chrome://inspect#devices。勾选 Discover USB devices,选中页面并连接 DevTools。然后在手机 Chrome 的菜单里选择 Install app(部分设备上为 Add to Home screen)。预期结果是安装流程出现在所连接的设备上,同时桌面 DevTools 可以检查手机中的实时页面。Chrome 的远程调试指南说明,Windows、macOS 或 Linux 都能发现设备并检查其内容。

2026-11-13 更正前的说明称,DevTools 的 Push 控件会发送所填载荷,Update on reload 会重新安装逐字节相同的 worker 并跳过等待阶段。Chrome 文档说明,Push 模拟不带载荷的推送通知,Update on reload 在每次加载页面时强制更新 Service Worker。

← 返回指南总览。