Lighthouse v3 遷移指南

本指南適用於符合以下條件的 Lighthouse v2 使用者：

• 透過節點或指令列執行 Lighthouse。
• 需要 Lighthouse 的 JSON 輸出內容。

如果您不適用上述情形，執行 Lighthouse 的工作流程大致相同。如要瞭解新功能和異動，請參閱 Lighthouse 3.0 公告。

叫用變更

Lighthouse 現在預設會計算模擬效能，節流設定也已大幅變更。

CLI 旗標

節點模組

在 Lighthouse v3 中，Node 模組接受與 CLI 相同的設定選項。之所以有破壞性變更，是因為第 2 版已忽略了許多選項，而現在 Lighthouse 實際上會影響 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 結果」的簡稱。這基本上就是第 2 版中的頂層物件，但第 3 版也會為此物件形狀導入破壞性變更。請參閱結果物件的變更。
• artifacts。在稽核時從 Chrome 收集的資料。此名稱先前與 LHR 的屬性互動。
• report。格式化的報表 HTML/JSON/CSV (以字串表示)。

結果物件變更

如「全新的 JSON 輸出內容中的頂層格式」一文所述，您可以透過 lhr 屬性取得稽核結果。在 v2 中，這個物件的內容基本上是頂層 JSON 輸出。不過，這個物件本身的形狀在 v3 中已經變更。下表列出所有異動內容。

• 如果資料列同時在「v2」v2和「v3」v2欄中有一個值，您應該將程式碼中 v2 屬性的所有參照替換為對等的 v3。
• 如果資料列的「v3」v3欄沒有值，「附註」v3欄便會說明您的選項。
• 請注意，ID 等項目代表預留位置文字。