Lighthouse v3 迁移指南

本指南适用于符合以下条件的 Lighthouse v2 用户：

• 从 Node 或命令行运行 Lighthouse。
• 依赖 Lighthouse 的 JSON 输出。

如果这些都不适合您，则运行 Lighthouse 的工作流大致相同。如需简要了解新功能和变更，请参阅正式推出 Lighthouse 3.0。

调用变更

Lighthouse 现在默认计算模拟性能，并且节流设置已大幅更改。

CLI 标志

节点模块

在 Lighthouse v3 中，Node 模块接受与 CLI 相同的配置选项。这是一项重大变更，因为 v2 中会忽略其中的许多选项，而现在，它们实际上会影响 Lighthouse 的运行方式。

const fs = require('fs');
const lighthouse = require('lighthouse');
async function run() {
  // `onlyCategories` was previously only available as a config setting.
  // `output` was previously only available in CLI.
  const flags = {onlyCategories: ['performance'], output: 'html'};
  const html = (await lighthouse('https://google.com/', flags)).report;
  fs.writeFileSync('report.html', html);
}

输出方面的变更

JSON 输出中的全新顶级格式

Lighthouse v3 返回的 JSON 对象现在包含三个顶级属性：

• lhr：审核结果。“Lighthouse Results”的简称。这本质上是 v2 中的顶级对象，但 v3 也对此对象的形状引入了破坏性更改。请参阅对结果对象的更改。
• artifacts：审核期间从 Chrome 收集的数据。之前，此属性与 LHR 的属性混合在一起。
• report：以字符串表示的格式化报告 HTML/JSON/CSV。

对结果对象的更改

如 JSON 输出中新的顶级格式中所述，审核结果无法通过 lhr 属性提供。在 v2 中，此对象的内容本质上是顶级 JSON 输出。不过，此对象本身的形状在 v3 中发生了变化。下表列出了所有更改。

• 如果某行在 v2 和 v3 列中都有值，则表示您应将代码中对 v2 属性的任何引用替换为 v3 等效值。
• 如果某行在 v3 列中没有值，则 Notes 列会说明您的选项。
• 请注意，ID 等项表示占位符文本。