Lighthouse v3 遷移指南

本指南適用於符合下列條件的 Lighthouse 第 2 版使用者：

• 透過 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 第 3 版傳回的 JSON 物件現在包含三個頂層屬性：

• lhr。稽核結果。是「Lighthouse 結果」的縮寫。這基本上是 v2 中的頂層物件，但 v3 也對此物件的形狀進行重大變更。請參閱「結果物件異動」。
• artifacts。稽核期間從 Chrome 收集的資料。這項屬性先前與 LHR 的屬性混淆。
• report：以字串格式呈現的 HTML/JSON/CSV 報表。

結果物件的變更

如「全新的 JSON 輸出內容頂層格式」一文所述，無法透過 lhr 屬性提供稽核結果。在第 2 版中，這個物件的內容基本上是頂層 JSON 輸出。不過，這個物件本身的形狀在第 3 版中已有所改變。下表列出所有變更。

• 如果資料列在 v2 和 v3 欄中都有值，表示您應該將程式碼中任何對 v2 屬性的參照，替換為 v3 等價項目。
• 如果資料列在 v3 資料欄中沒有值，請參閱 Notes 欄說明的選項。
• 請注意，ID 等項目代表預留位置文字。