跳转到内容

性能中的概念

PWA 类别移除后的 Lighthouse

发布于 更新于

Lighthouse 是开源自动化工具。它针对指定网页运行审计并生成报告。官方文档列出的使用方式包括 Chrome DevTools、命令行、Node 模块、PageSpeed Insights 和 Lighthouse CI。

Chrome 126 捆绑 Lighthouse 12.0.0,其发布说明明确列出移除 PWA 类别。Lighthouse 仍可审计网页质量,但这个版本的报告不再提供原来的 PWA 类别。

把 URL 交给 Lighthouse 后,它会针对页面运行一系列审计。每个失败项都链接到参考说明,解释该审计的重要性以及修复方式(Introduction to Lighthouse,Chrome for Developers)。同一份概览列出了性能、无障碍、SEO 等审计方向。PWA 类别移除后,文档没有定义统一的 PWA 安装评分。

Chrome DevTools 在 Chrome 内提供 Lighthouse 工作流。命令行方式可安装 lighthouse 包或直接调用其可执行文件,再传入 URL 和选项。Node 工作流让 JavaScript 调用 Lighthouse。官方概览还把 PageSpeed Insights 列为运行方式,并推荐 Lighthouse CI 防止回归。

Lighthouse 12 流水线应把固定版本的 CLI 文档视为自动化参数契约。文档列出 --only-categories 可用的 accessibility、best-practices、performance 和 seo 值,说明 --chrome-flags 会把参数传给 Chrome,并用 --output 与 --output-path 选择 JSON 格式及保存位置(Lighthouse v12.0.0 CLI options,GoogleChrome/lighthouse)。这里固定到 v12.0.0,是为了让选项文档、下方示例与 Chrome 126 的类别移除说明保持同一大版本。对应的结果类型给出了契约的输出部分:完整结果包含字符串 lighthouseVersion,categories 则是以类别标识符为键的记录。每个类别的 score 类型为 number | null,所以即使类别存在,消费者也不能无条件假设其分数一定是数字(Lighthouse v12.0.0 result type,GoogleChrome/lighthouse)。先检查产物与所需类别键,再读取分数,可以让 CI 报出具体缺少的类别,而不是稍后才因未检查的属性访问失败。

Chrome 126 的 DevTools 发布说明写明其运行 Lighthouse 12.0.0,并在改动列表中使用 PWA category removal 这个标签(What’s new in DevTools, Chrome 126,Chrome for Developers)。Lighthouse 的移除 issue 属于 v12.0 里程碑,任务包括从报告及 JSON 结果中去掉该类别(Remove PWA Category,GoogleChrome/lighthouse)。

Chrome 的可安装性文档解释了背景,但旧审计项不能直接等同于浏览器要求。文档说明 Chromium 的安装标准包括带有名称、图标等字段的 manifest,以及带 fetch 处理函数的 Service Worker。Chrome 从移动端 108 和桌面端 112 开始,取消了菜单安装对 fetch 处理函数的要求。同一文档也说明,当时安装提示算法仍要求 fetch 处理函数(Revisiting Chrome’s installability criteria,Chrome for Developers)。

Lighthouse 输出与浏览器安装界面应分别取证。Lighthouse 报告描述实际运行的审计。浏览器安装行为由浏览器自己的标准和界面决定。浏览器检测到页面可安装时可能触发 beforeinstallprompt,但 MDN 把这个事件标为有限可用。因此,没有收到事件不能证明站点损坏,也不能证明浏览器没有其他安装入口。

安装提示兼容性数据单独记录浏览器与平台证据。需要按具体浏览器决策时,应查看这类数据,不能从网页质量审计推导安装支持。

官方文档中的 DevTools 方式从 Chrome DevTools 运行 Lighthouse。命令行和 Node 方式要求本机已安装 Google Chrome,PageSpeed Insights 则从网页运行 Lighthouse(Introduction to Lighthouse,Chrome for Developers)。这些是审计工具的运行要求,不是被审计页面或其安装流程的浏览器支持声明。

以下示例保留 Lighthouse 报告的用途,同时不再依赖已经移除的类别。

Lighthouse v12.0.0 CLI 选项支持选择类别、向 Chrome 传递参数,并把 JSON 输出到指定路径。把包版本固定在 devDependencies,运行项目需要的类别,再把 JSON 留作构建产物。

Terminal window
npm install --save-dev lighthouse@12
mkdir -p artifacts/lighthouse
npx lighthouse https://example.com \
--only-categories=performance,accessibility,best-practices,seo \
--output=json \
--output-path=artifacts/lighthouse/report.json \
--chrome-flags="--headless"
test -s artifacts/lighthouse/report.json
node -e "const r=require('./artifacts/lighthouse/report.json'); console.log(r.lighthouseVersion)"

最后两条命令检查报告是否写入,并打印报告自身记录的 Lighthouse 版本。它们不会从 pwa 类别推导可安装性。

先检测 beforeinstallprompt。浏览器提供事件后才保存它;回退分支则保留安装帮助链接。MDN 记录了用 preventDefault() 延后提示,并在用户操作后调用 prompt() 的方式。

const installButton = document.querySelector("#install");
const installHelp = document.querySelector("#install-help");
let installPrompt = null;
installButton.hidden = true;
installHelp.hidden = false;
if ("onbeforeinstallprompt" in window) {
window.addEventListener("beforeinstallprompt", (event) => {
event.preventDefault();
installPrompt = event;
installButton.hidden = false;
});
} else {
installHelp.textContent = "请查看浏览器的安装说明。";
}
installButton.addEventListener("click", async () => {
if (!installPrompt) return;
await installPrompt.prompt();
installPrompt = null;
installButton.hidden = true;
});

事件缺失时,回退内容仍然可见。代码不会把事件缺失写成 Lighthouse 失败。

构建应区分“报告不存在或无法读取”与“审计得分低”。下面的 Node 脚本先检查报告结构,再读取指定类别。这些检查对应固定版本的 Lighthouse 结果类型:categories 是记录,每个类别的分数是数字或 null。

import fs from "node:fs";
const path = "artifacts/lighthouse/report.json";
if (!fs.existsSync(path)) {
throw new Error(`Lighthouse report missing: ${path}`);
}
const report = JSON.parse(fs.readFileSync(path, "utf8"));
const required = ["performance", "accessibility"];
for (const id of required) {
if (!report.categories?.[id]) {
throw new Error(`Lighthouse category missing: ${id}`);
}
}
console.log(required.map((id) => `${id}=${report.categories[id].score}`).join(" "));

失败路径会指出哪个必需类别缺失。脚本不要求 categories.pwa;Lighthouse 项目已跟踪并完成该类别的移除。

规范

规范状态
无。