LighthouseでJavaScriptの未使用分を後から読み込む方法
Lighthouse の「使用していない JavaScript の削減」という指摘は、ボタンを押したときなど、ページを開いた後にしか使わないライブラリを import() で後から読み込むようにすると消えます。ページの表示を軽くしたいときや、スマホの通信量を減らしたいときに見る指摘です。検証したページでは、グラフのライブラリ(Chart.js)を後から読み込むようにしただけで、ページを開いたときに読み込む JavaScript が約 71KiB から約 1.6KiB(gzip で圧縮した転送量)になり、指摘が消えました。検証環境で Lighthouse を実際に動かし、その出力を手を加えずに抜き出して載せています。
検証環境は Ubuntu 24.04、Node.js 22、Lighthouse 13.6.0(npm のパッケージ)、Vite 6.4.6、Chart.js 4.6.1 です。Lighthouse はコマンドラインから既定の設定(モバイル)で実行し、パフォーマンスのカテゴリーだけを、ページごとに3回ずつ調べました。ページは検証環境で動かした小さなサーバー(localhost:8080)から gzip で配りました。Chrome は Chrome for Testing 153 で、ボタンを押す操作の確認には Playwright 1.63.0 を使いました。Chrome の DevTools にある Lighthouse パネル、PageSpeed Insights、デスクトップの設定、公開しているサイト、React の lazy や webpack での分け方、実機のスマホでの操作は試していません。
指摘が出たページ
検証に使ったのは、見出しと説明文と「グラフを表示」のボタンだけのページです。ボタンを押すと、Chart.js で猫の体重のグラフを描きます。グラフはボタンを押すまで使いませんが、ファイルの先頭で Chart.js を読み込んでいます。
import { Chart, registerables } from 'chart.js';
import { weights } from './data';
Chart.register(...registerables);
const button = document.getElementById('show') as HTMLButtonElement;
const status = document.getElementById('status') as HTMLParagraphElement;
button.addEventListener('click', () => {
document.getElementById('chart-area')!.hidden = false;
const canvas = document.getElementById('chart') as HTMLCanvasElement;
new Chart(canvas, {
type: 'line',
data: { labels: weights.map((w) => w.month), datasets: [{ label: '体重(kg)', data: weights.map((w) => w.kg) }] },
options: { animation: false },
});
status.textContent = 'グラフを表示しました';
button.disabled = true;
});
Vite でビルドすると、Chart.js を含めて1つのファイル(gzip 後 72.42kB)になりました(ビルドの出力は、途中の経過の行を省いています)。どのライブラリのどこが使われていないかを Lighthouse に表示させるため、vite.config.ts で build: { sourcemap: true } を指定して、ソースマップも出力しています。
$ (cd before && npx vite build)
dist/index.html 0.86 kB │ gzip: 0.59 kB
dist/assets/index-eIwfLpOq.js 210.50 kB │ gzip: 72.42 kB │ map: 888.62 kB
このページに Lighthouse を実行しました。結果の JSON から、点数と指標、この指摘の結果を、小さなスクリプト(summarize.mjs)で抜き出しています。
$ npx lighthouse http://localhost:8080/before/ --only-categories=performance --output=json --output=html --output-path=./out/before-1 --chrome-flags="--headless=new --no-sandbox" --quiet
exit: 0
lighthouseVersion: 13.6.0 requestedUrl: http://localhost:8080/before/
performance score: 100
FCP: 0.6 s (score 1) LCP: 0.6 s (score 1) SI: 0.6 s (score 1) TBT: 10 ms (score 1) CLS: 0 (score 1)
unused-javascript: score=0.5 scoreDisplayMode=metricSavings title="Reduce unused JavaScript" displayValue="Est savings of 64 KiB" metricSavings={"FCP":0,"LCP":0}
- http://localhost:8080/before/assets/index-eIwfLpOq.js total=72418 wasted=65251 (90.1%)
…../node_modules/chart.js/dist/chart.js size=58207 wasted=54383
…../node_modules/chart.js/dist/chunks/index.js size=10985 wasted=9001
…../node_modules/@kurkle/color/dist/color.esm.js size=2688 wasted=1620
scripts loaded: /before/assets/index-eIwfLpOq.js(72647B)
読み込んだ JavaScript のうち 90.1% が、ページを開いたときには使われていないという結果です。日本語の表示(--locale=ja)では、項目の名前は「使用していない JavaScript の削減」、見積もりは「推定される削減サイズ 64 KiB」と出ました。
HTML のレポートでは、オレンジの四角が付いた項目として出ました。ソースマップがあるので、ファイルの下に、使われていない量の多いライブラリのファイルが並びます。このページでは、ほとんどが chart.js の本体でした。

Lighthouse の公式の解説には、使われていないコードが 20KiB を超える JavaScript のファイルに指摘を出すと書かれています。Lighthouse 13.6.0 のソースコードでも、ファイルごとの使われていない量(gzip などで圧縮した後の大きさに換算した値)が 20 * 1024 バイト以下なら、表に載せない作りでした。表の下に並ぶライブラリのファイルは、使われていない量の多い順に5つまでです。
点数は直す前から100だった
このページのパフォーマンスの点数は、3回とも 100 でした。FCP と LCP は 0.6 秒、TBT は 0〜10 ミリ秒で、指標はどれも満点です。項目に「Unscored」と出ているとおり、この指摘そのものは点数の計算に入りません。Lighthouse 13.6.0 の既定の設定ファイルでも、この項目の重みは 0 です。
項目の左に出る記号がオレンジの四角になるか赤い三角になるかは、Lighthouse が見積もった指標の改善の見込み(metricSavings)で決まります。Lighthouse 13.6.0 のソースコード(audit.js)では、見込みが 0 なら 0.5(オレンジの四角)、少しでもあれば 0(赤い三角)になります。上の3回はどれも見込みが 0 でオレンジでした。記録用に実行した3回より前に、試しに実行したときは、1回だけ LCP の見込みが 300 ミリ秒と出て、その回は 0(赤い三角)になりました。
lighthouseVersion: 13.6.0 requestedUrl: http://localhost:8080/before/
performance score: 100
FCP: 0.6 s (score 1) LCP: 1.1 s (score 1) SI: 0.6 s (score 1) TBT: 50 ms (score 1) CLS: 0 (score 1)
unused-javascript: score=0 scoreDisplayMode=metricSavings title="Reduce unused JavaScript" displayValue="Est savings of 64 KiB" metricSavings={"FCP":0,"LCP":300}
点数が 100 でも、この指摘は出ます。この指摘で減らせるのは、ページを開いたときに転送する量です。
ボタンを押したときに import() で読み込む
直し方は、ファイルの先頭の import をやめて、ボタンを押したときに import() で Chart.js を読み込むことです。MDN の import() の解説には、import() を使うと、モジュールを条件に応じて、または必要になったときに読み込めると書かれています。ボタンを押したときに読み込む例も載っています。
import { weights } from './data';
const button = document.getElementById('show') as HTMLButtonElement;
const status = document.getElementById('status') as HTMLParagraphElement;
button.addEventListener('click', async () => {
button.disabled = true;
status.textContent = 'グラフを読み込んでいます…';
const { Chart, registerables } = await import('chart.js');
Chart.register(...registerables);
document.getElementById('chart-area')!.hidden = false;
const canvas = document.getElementById('chart') as HTMLCanvasElement;
new Chart(canvas, {
type: 'line',
data: { labels: weights.map((w) => w.month), datasets: [{ label: '体重(kg)', data: weights.map((w) => w.kg) }] },
options: { animation: false },
});
status.textContent = 'グラフを表示しました';
});
Chart.register(...registerables) も、読み込んだ後のクリックの処理の中に移しました。読み込みには時間がかかることがあるので、押した直後に「グラフを読み込んでいます…」と表示し、ボタンを押せなくしています。
ビルドし直すと、Vite は Chart.js を別のファイル(chart-DVLHtTfI.js)に分けました(出力は途中の経過の行を省いています)。ページを開いたときに読むファイル(index-PtCuIhBs.js)は、gzip 後 1.39kB です。
$ (cd after && npx vite build)
dist/index.html 0.85 kB │ gzip: 0.59 kB
dist/assets/index-PtCuIhBs.js 2.78 kB │ gzip: 1.39 kB │ map: 2.30 kB
dist/assets/chart-DVLHtTfI.js 209.93 kB │ gzip: 72.11 kB │ map: 886.61 kB
出力された index.html には、index-PtCuIhBs.js を読む <script> だけが入っていました。Chart.js のファイルを先読みする <link> は入っていません。
Lighthouse を実行し直すと、指摘は消えました。ページを開いたときに読み込まれた JavaScript は index-PtCuIhBs.js の 1,609 バイトだけです。指摘が出ないことと、読み込まれた JavaScript は、3回とも同じでした。
$ npx lighthouse http://localhost:8080/after/ --only-categories=performance --output=json --output=html --output-path=./out/after-1 --chrome-flags="--headless=new --no-sandbox" --quiet
exit: 0
lighthouseVersion: 13.6.0 requestedUrl: http://localhost:8080/after/
performance score: 100
FCP: 0.6 s (score 1) LCP: 0.6 s (score 1) SI: 0.6 s (score 1) TBT: 10 ms (score 1) CLS: 0 (score 1)
unused-javascript: score=1 scoreDisplayMode=metricSavings title="Reduce unused JavaScript" displayValue="" metricSavings={"FCP":0,"LCP":0}
scripts loaded: /after/assets/index-PtCuIhBs.js(1609B)

押したときにグラフが出るかを確かめる
指摘が消えても、ボタンを押してグラフが出なければ意味がありません。Playwright でページを開き、読み込まれた JavaScript を記録してから、ボタンを押しました。グラフを描く <canvas> の中で、透明でない画素がいくつあるかも数えています(painted pixels)。
$ node click.cjs
before: on load=/before/assets/index-eIwfLpOq.js | after click=(none) | status right after click="グラフを表示しました" | click→drawn=160ms | painted pixels=7838
before (slow network): on load=/before/assets/index-eIwfLpOq.js | after click=(none) | status right after click="グラフを表示しました" | click→drawn=130ms | painted pixels=7838
after: on load=/after/assets/index-PtCuIhBs.js | after click=/after/assets/chart-DVLHtTfI.js | status right after click="グラフを読み込んでいます…" | click→drawn=132ms | painted pixels=7838
after (slow network): on load=/after/assets/index-PtCuIhBs.js | after click=/after/assets/chart-DVLHtTfI.js | status right after click="グラフを読み込んでいます…" | click→drawn=590ms | painted pixels=7838
直した後のページ(after)では、ボタンを押した後に chart-DVLHtTfI.js が読み込まれ、直す前と同じ数(7,838 個)の画素が描かれました。

ただし、押してからグラフが出るまでの時間は、回線が遅いと長くなりました。Chrome の通信速度を往復 150 ミリ秒・約 1.6Mbps に絞ると(出力の slow network)、直す前は 130 ミリ秒、直した後は 590 ミリ秒でした。直す前は Chart.js を読み込み済みなので、回線の速さに関係なくすぐ描けます。直した後は、押してから 72KB 程度のファイルを取りに行くため、そのぶん待ちます。
ボタンにマウスが乗ったときに読み込み始める
押してからグラフが出るまでの待ちを縮めるため、ボタンにマウスのポインターが乗ったとき(pointerenter)や、キーボードでフォーカスが来たとき(focus)に、import() を始めるようにしました。読み込みの Promise を変数に入れておき、押したときはその Promise を待ちます。次のコードは、押したときだけ読み込む書き方から変わったところだけを抜き出し、省いた部分をコメントで示しています(ほかのコメントは検証に使ったコードのままです)。
// ボタンに指が乗った・フォーカスが来た時点で読み込みを始める(2回目以降は同じ Promise を使う)
let chartModule: Promise<typeof import('chart.js')> | undefined;
const loadChart = () => (chartModule ??= import('chart.js'));
button.addEventListener('pointerenter', loadChart, { once: true });
button.addEventListener('focus', loadChart, { once: true });
button.addEventListener('click', async () => {
button.disabled = true;
status.textContent = 'グラフを読み込んでいます…';
const { Chart, registerables } = await loadChart();
// ここから先は、ボタンを押したときだけ読み込む書き方と同じ
このページでも、Lighthouse の指摘は3回とも出ませんでした。ページを開いたときに読み込まれた JavaScript は 1,643 バイトのファイルだけです。
同じ遅い回線で、ポインターをボタンに乗せてから1秒後に押す操作を3回ずつ比べました。@ の後ろは、ページを開き始めてからの時間です。
$ node hover.cjs
after run1: hover@398ms, click@1399ms | requests: /after/assets/index-PtCuIhBs.js@167ms, /after/assets/chart-DVLHtTfI.js@1420ms | click→drawn=573ms
after run2: hover@401ms, click@1403ms | requests: /after/assets/index-PtCuIhBs.js@168ms, /after/assets/chart-DVLHtTfI.js@1425ms | click→drawn=565ms
after run3: hover@397ms, click@1398ms | requests: /after/assets/index-PtCuIhBs.js@169ms, /after/assets/chart-DVLHtTfI.js@1420ms | click→drawn=565ms
hover run1: hover@401ms, click@1402ms | requests: /hover/assets/index-CiC3nv7O.js@167ms, /hover/assets/chart-Dp5bEPeZ.js@400ms | click→drawn=83ms
hover run2: hover@393ms, click@1394ms | requests: /hover/assets/index-CiC3nv7O.js@168ms, /hover/assets/chart-Dp5bEPeZ.js@392ms | click→drawn=105ms
hover run3: hover@400ms, click@1401ms | requests: /hover/assets/index-CiC3nv7O.js@171ms, /hover/assets/chart-Dp5bEPeZ.js@399ms | click→drawn=85ms
ポインターが乗った時点で読み込みを始めるページ(hover)では、Chart.js のファイルを取りに行く時刻が、ポインターを乗せた時刻とほぼ同じになりました。押してからグラフが出るまでは 83〜105 ミリ秒で、押したときだけ読み込むページ(565〜573 ミリ秒)より短くなりました。
一方、タッチ操作を想定して、Playwright のブラウザーをタッチ操作ができる設定(hasTouch、isMobile)にし、tap で押したときは、差が出ませんでした。
$ node tap.cjs
after tap: tap@1338ms | requests: /after/assets/index-PtCuIhBs.js@167ms, /after/assets/chart-DVLHtTfI.js@1408ms | tap→drawn=615ms
hover tap: tap@1344ms | requests: /hover/assets/index-CiC3nv7O.js@169ms, /hover/assets/chart-Dp5bEPeZ.js@1401ms | tap→drawn=608ms
タップでは、Chart.js のファイルを取りに行く時刻が、押した時刻とほぼ同じでした。ポインターを先に乗せる操作がないので、先に読み込み始める効果はありません。スマホで押してからの待ちが気になるときは、押した直後に「グラフを読み込んでいます…」と表示しておく処理が役に立ちます。
後から読み込む候補になるのは、ボタンを押す・タブを切り替えるなど、ページを開いた後の操作で初めて使うライブラリです。直した後は、指摘が消えたことに加えて、その操作で実際に機能が動くことも確かめます。





