Lighthouseの監査結果をWeb品質の差分として読む

Lighthouseが数値化するWebの観測面

Lighthouse は、ウェブアプリとウェブページを分析する JavaScript 製ツールです。README によると、その目的は最新のパフォーマンス指標を収集し、開発者のベストプラクティスに関する洞察を提供することです。CLI のヘルプテキストには、accessibility、best-practices、performance、seo の4つの監査カテゴリが列挙されています。リポジトリの説明では、同じ枠組みに「自動監査」という言葉が追加されています。README は各カテゴリが具体的に何を採点するかの正確な定義を示しておらず、採点ルールの確認には監査ソースコードを読む必要があります。

LighthouseはWeb appとWeb pageを解析し、modern performance metricsとdeveloper best practicesのinsightsを集める。監査結果はページの観測値であって、サイト全体の可用性やバックエンドの品質を直接証明するものではない。 GoogleChrome/lighthouseのREADMEとメタデータに基づく判断であり、実行結果や性能測定を意味しない。導入範囲はここで挙げた形式、コマンド、設定ファイルに限って確認する。

Chrome、拡張機能、Node CLIの使い分け

README は、Lighthouse を実行する4つの方法を説明しています。Chrome DevTools では、Lighthouse パネルがブラウザに直接組み込まれており、DevTools を開いてパネルを選択し、「レポートを生成」を押します。Chrome ウェブストアの拡張機能も同様の機能を提供し、DevTools 統合より前に存在していました。Node CLI は npm install -g lighthouse でグローバルインストールし、lighthouse <url> で実行します。Node 22（LTS）以降が必要です。プログラムからの利用については、Node モジュールが docs/readme.md の「プログラムでの使用」に文書化されています。

READMEはChrome DevTools、Chrome extension、Node CLI、Node moduleの4経路を案内する。人が一度見るならDevTools、CIでURLと出力を固定するならCLI、別のNode処理へ組み込むならmoduleという分け方ができる。 GoogleChrome/lighthouseのREADMEとメタデータに基づく判断であり、実行結果や性能測定を意味しない。導入範囲はここで挙げた形式、コマンド、設定ファイルに限って確認する。

CLIフラグとレポート生成の単位

CLI は多数のフラグを受け入れます。出力は json、html、csv のいずれかで、複数指定が可能で、デフォルトは html です。--output-path フラグでファイルの書き出し先を制御し、--view で HTML レポートをブラウザで開きます。ライフサイクルフラグ -G（収集モード）と -A（監査モード）を使用すると、ある実行でブラウザからアーティファクトを収集し、後でブラウザに触れずに処理できます。README は、スロットリング方法、画面エミュレーション、ロケール、追加ヘッダー、ブロックする URL パターン、プラグイン、エラー報告のフラグも列挙しています。完全なリストは README に再掲された --help 出力にあります。

CLI options、report閲覧、online viewerを別節で持ち、設定可能なrunと結果の表示を分離している。監査対象URL、デバイス条件、カテゴリ、出力形式を同じジョブ定義に保存しないと、数値差分の原因を追いにくい。 GoogleChrome/lighthouseのREADMEとメタデータに基づく判断であり、実行結果や性能測定を意味しない。導入範囲はここで挙げた形式、コマンド、設定ファイルに限って確認する。

スロットリングとローカル処理の読み方

FAQ によると、Lighthouse はデフォルトでネットワークと CPU のスロットリングを適用します。ネットワークは低速 4G 接続をエミュレートし、CPU はマシンのデフォルト速度の 4 分の 1 に低下します。パフォーマンススコアは、4G 接続で約200ドルの中級スマートフォンを使う一般的なモバイルユーザーが体験する値を反映しています。同じ FAQ は、結果がリモートサーバーに送信されることは決してないと述べています。監査はローカルで、マシンにインストールされた Chrome を使って実行されます。エラー報告はオプトインで、CLI は初回実行時にプロンプトを表示し、拒否しても機能に影響しません。

READMEにはnetwork throttlingの挙動と改善方法を問うFAQがある一方、実行環境のCPU、回線、Chrome版で結果が変わる点を一つの数値へ畳み込む仕様は資料だけでは確定しない。比較では条件をそろえる必要がある。 GoogleChrome/lighthouseのREADMEとメタデータに基づく判断であり、実行結果や性能測定を意味しない。導入範囲はここで挙げた形式、コマンド、設定ファイルに限って確認する。

オンラインビューアーへ渡る成果物

Lighthouse は HTML または JSON のレポートを生成できます。HTML レポートは監査結果をインラインで表示します。JSON 出力は、ファイルをページにドラッグするか、任意の HTML レポートの「エクスポート」ボタンを使うことで、googlechrome.github.io/lighthouse/viewer/ のオンラインビューアーで表示できます。ビューアーでは、右上の共有アイコンをクリックして GitHub にサインインするとレポートを共有でき、共有されたレポートはユーザーのアカウントのシークレット gist として保存されます。README は、デフォルトではレポートがテスト URL と日付に基づくファイル名で書き出されることも述べています。

レポートはオンラインビューアーで表示できるとREADMEにある。URLやHTMLの内容を外部へ送る運用にできるかは組織のポリシー次第で、ローカルにJSONやHTMLを残す経路と共有する経路を分けて考えるべきだ。 GoogleChrome/lighthouseのREADMEとメタデータに基づく判断であり、実行結果や性能測定を意味しない。導入範囲はここで挙げた形式、コマンド、設定ファイルに限って確認する。

プラグインとカスタム監査の境界

README は、Lighthouse を拡張するいくつかの方法を説明しています。カスタム監査とギャザラーを作成でき、docs/recipes/custom-audit のレシピがその例を示しています。プラグインは文書化された拡張メカニズムで、lighthouse-plugin-field-performance や lighthouse-plugin-publisher-ads などの例が挙げられています。README はまた、WebPageTest、HTTPArchive、Calibre、CI で監査を実行する公式の GoogleChrome/lighthouse-ci など、Lighthouse を統合する多数のサードパーティサービスとツールを列挙しています。この統合リストは参考用であり、README は記載された製品の品質を評価していません。ある統合が自分の用途に合うか判断するには、その製品自身のドキュメントを確認する必要があります。

Pluginsとcustom auditsの仕組みは、標準カテゴリで足りない検査を拡張する入口になる。プラグインの実装契約やCIでの失敗条件は、リポジトリのDocs & Recipesと開発者向けSetupを読んでから決めたい。 GoogleChrome/lighthouseのREADMEとメタデータに基づく判断であり、実行結果や性能測定を意味しない。導入範囲はここで挙げた形式、コマンド、設定ファイルに限って確認する。

v13.4.1を固定して比較する

開発については、README はリポジトリをクローンし、yarn をインストールして、yarn と yarn build-all を実行するよう指示しています。CLI は node cli http://example.com で起動できます。テストは lint、unit、smoke に分かれており、yarn test で全部を実行し、yarn type-check で TypeScript コンパイラを実行します。ドキュメントの変更は、ローカルで yarn build-pack && yarn test-docs を実行する必要があります。このプロジェクトは Apache-2.0 でライセンスされており、ライセンスの抜粋は永続的、世界的、非独占的、無償の著作権ライセンスと条件付きの特許ライセンスを付与します。セキュリティ保証、サポート、保証については何も述べていません。

Apache-2.0で直近版はv13.4.1。Web性能の回帰を追うチームには向くが、監査スコアを合否の唯一の基準にする用途には向かない。まず同じURL、Chrome条件、カテゴリ、出力をv13.4.1で二度取得して差分の扱いを決める。 GoogleChrome/lighthouseのREADMEとメタデータに基づく判断であり、実行結果や性能測定を意味しない。導入範囲はここで挙げた形式、コマンド、設定ファイルに限って確認する。

編集部の結論

LighthouseはWeb appとWeb pageを解析し、modern performance metricsとdeveloper best practicesのinsightsを集める。監査結果はページの観測値であって、サイト全体の可用性やバックエンドの品質を直接証明するものではない。 Pluginsとcustom auditsの仕組みは、標準カテゴリで足りない検査を拡張する入口になる。プラグインの実装契約やCIでの失敗条件は、リポジトリのDocs & Recipesと開発者向けSetupを読んでから決めたい。 Apache-2.0で直近版はv13.4.1。Web性能の回帰を追うチームには向くが、監査スコアを合否の唯一の基準にする用途には向かない。まず同じURL、Chrome条件、カテゴリ、出力をv13.4.1で二度取得して差分の扱いを決める。 採用するのはこの条件を受け入れられる利用者で、資料にない保証や別用途を求める利用者には向かない。最初に確認する対象はGoogleChrome/lighthouseのREADMEに記載された具体的な入力、コマンド、設定、リリース番号である。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes