LighthouseでCSSとJSのminifyを勧められたときの直し方

​​Lighthouse​CSS,esbuild,gzip,JavaScript,パフォーマンス

Lighthouse に「Minify CSS」「Minify JavaScript」(日本語の表示では「CSS の最小化」「JavaScript の最小化」)と出たときは、配信する前の CSS と JavaScript を minify(空白やコメントを取り除き、短く書き直すこと)すれば直ります。ページの表示を速くしたいときや、スマホで読み込む量を減らしたいときに見る項目です。

検証したページでは、esbuild で minify したファイルに差し替えると、2つの指摘がどちらも消えました。CSS と JavaScript の転送量の合計は、gzip で圧縮しないサーバーでは 844,908 バイトから 309,252 バイトに、gzip で圧縮するサーバーでは 133,324 バイトから 58,798 バイトになりました。

補足

検証環境は Ubuntu 24.04、Node.js 22、Lighthouse 13.6.0(npm のパッケージ)、esbuild 0.28.2 です。Lighthouse はコマンドラインから既定の設定(モバイル)で、パフォーマンスのカテゴリーだけを、ページごとに1回ずつ実行しました。Chrome は Chrome for Testing 153 で、環境変数 CHROME_PATH で指定しました。ページの動きの確認には Playwright 1.63.0 を使いました。検証用のページは、Bootstrap 5.3.3 の bootstrap.css と lodash 4.17.21 の lodash.js(どちらも minify していない版)に、検証用に作った小さな CSS と JavaScript を足したものです。ページは同じ VM の中で動かした Node.js の小さなサーバーから、gzip で圧縮しない場合と、gzip(レベル 6)で圧縮する場合の2とおりで配信しました。Chrome の DevTools にある Lighthouse パネル、PageSpeed Insights、デスクトップの設定、Vite や webpack、Terser などほかのツールでの minify、WordPress のプラグイン、Brotli での圧縮は試していません。

指摘が出たページ

検証用のページは、猫の体重の記録を表にするだけのものです。読み込むファイルは次の4つです。

ファイル 大きさ(バイト) 中身
css/bootstrap.css 281,046 Bootstrap の minify していない版
css/app.css 477 検証用に作った CSS(コメント付き)
js/lodash.js 544,098 lodash の minify していない版
js/app.js 18,573 検証用に作った JavaScript(コメント付き)

gzip で圧縮しないサーバーから配信し、Lighthouse を実行しました。結果の JSON から、minify に関わるところを小さなスクリプト(summarize.mjs)で抜き出すと、次のようになりました。

console
$ npx lighthouse http://localhost:8080/ --only-categories=performance --output=json --output=html --output-path=./out/src-identity --chrome-flags="--headless=new --no-sandbox" --quiet
exit: 0
$ node summarize.mjs out/src-identity.report.json
lighthouseVersion: 13.6.0  formFactor: mobile  throttling: simulate
performance score: 66  FCP: 5.5 s  LCP: 5.5 s  TBT: 0 ms
unminified-css: score=0 scoreDisplayMode=metricSavings title="Minify CSS" displayValue="Est savings of 46 KiB" metricSavings={"FCP":300,"LCP":300}
  /css/bootstrap.css  totalBytes=281222  wastedBytes=46937  wastedPercent=16.7
unminified-javascript: score=0 scoreDisplayMode=metricSavings title="Minify JavaScript" displayValue="Est savings of 401 KiB" metricSavings={"FCP":2400,"LCP":2400}
  /js/lodash.js  totalBytes=544098  wastedBytes=398556  wastedPercent=73.3
  /js/app.js  totalBytes=18573  wastedBytes=12094  wastedPercent=65.1

(読み込んだファイルの一覧の行は省いています。)

HTML のレポートでは、「Minify JavaScript」の項目を開くと、ファイルごとの転送量(Transfer Size)と、減らせる見込み(Est Savings)が並びます。

LighthouseのレポートでMinify JavaScriptの項目を開いた画面。Est savings of 401 KiBと出ていて、表には/js/lodash.jsが531.3 KiBのうち389.2 KiB、/js/app.jsが18.1 KiBのうち11.8 KiBを減らせると出ている
gzip で圧縮しないサーバーでのレポート

検証用に作った app.css は、コメントと空白を多めに入れても一覧に出ませんでした。理由は後の節で説明します。

この2つの項目は、Lighthouse 13.6.0 の設定では「Diagnostics」(日本語の表示では「診断」)のグループに入っていて、パフォーマンスの点数への重みは 0 です。レポートにも「Unscored」と出ます。項目そのものは点数に入りませんが、ファイルが小さくなれば FCP(最初に何かが表示されるまでの時間)などの指標が変わり、点数も変わります。

esbuild で minify したファイルに差し替える

minify には esbuild を使いました。CSS と JavaScript のどちらも、--minify を付けるだけで minify できます。元のファイルを src/ に置き、minify したものを dist/ に書き出しました。

console
$ npx esbuild src/css/bootstrap.css src/css/app.css src/js/lodash.js src/js/app.js --minify --outdir=dist --outbase=src

  dist/css/bootstrap.css  227.6kb
  dist/js/lodash.js        71.1kb
  dist/js/app.js            2.5kb
  dist/css/app.css          155b 

--outbase=src は、src/ の下のフォルダの形(css/、js/)を、そのまま dist/ の下に作るための指定です。HTML はそのまま dist/ にコピーしたので、<link> や <script> のパスは変えていません。

npx esbuild --help によると、--minify は3つの指定をまとめて有効にします。空白を取り除く --minify-whitespace、変数などの名前を短くする --minify-identifiers、同じ意味の短い書き方に直す --minify-syntax です。検証用に作った app.js は、次のように関数の名前が1文字になり、1000 は 1e3 になりました。

js
(function(){"use strict";function c(n){const o=n/1e3;return _.round(o,2)}function e(n){const o=n/1e3;return _.round(o,2)}...

(長いので、先頭だけを載せています。)

lodash.js の先頭の @license のコメントと、bootstrap.css の先頭の /*! で始まるコメントは、minify した後も残りました。esbuild の --help には、こうしたライセンスのコメント(legal comments)の置き場所を決める --legal-comments があり、バンドルしないときの既定値は inline(その場に残す)と書かれています。

minify した後も、ページが同じように動くかを Playwright で確かめました。表の行数(40行)、前の日より増えた行の数(19行)、平均の文、増えた行の文字の色は、minify の前と同じでした。コンソールのエラーはどちらも 0 件でした。

差し替えた後のレポート

gzip で圧縮しないサーバーと、gzip で圧縮するサーバーの両方で、元のファイルと minify したファイルを配信し、Lighthouse の結果を比べました。転送量は、Lighthouse の結果の network-requests の値です。

配信のしかた CSS の転送量 JavaScript の転送量 指摘 点数 FCP
minify なし・gzip なし 281,872 563,036 CSS と JS の両方 66 5.5 秒
minify あり・gzip なし 233,526 75,726 なし 93 2.6 秒
minify なし・gzip あり 34,077 99,247 CSS と JS の両方 99 1.7 秒
minify あり・gzip あり 31,353 27,445 なし 100 1.3 秒

(転送量の単位はバイトで、2つのファイルの合計です。FCP は、Lighthouse がモバイルの回線を想定して見積もった値で、1回だけ実行した結果です。)

minify したページでは、gzip のあり・なしにかかわらず、「Minify CSS」と「Minify JavaScript」はどちらも合格になり、一覧に何も出ませんでした。

減り方は、CSS と JavaScript で大きく違いました。gzip なしで比べると、lodash.js は 544,098 バイトから 72,832 バイトになりましたが、bootstrap.css は 281,046 バイトから 233,022 バイトにしかなりませんでした。gzip ありで比べると、CSS の転送量は 34,077 バイトから 31,353 バイトと、1割も減っていません。

Lighthouse の見込みは、空白とコメントの分だけ

Lighthouse 13.6.0 のコードを見ると、Lighthouse は減らせる見込みを次のように出しています。

  1. ファイルの中身から、空白とコメントを除いた文字数を数える(/*! や @license のようなライセンスのコメントは、除かずに数える)
  2. 除いた分の割合を、そのファイルの転送量(JavaScript はレスポンスヘッダーを除いた大きさ)に掛ける
  3. 割合が小さいとき(CSS は 5% 未満、JavaScript は 10% 未満)や、見込みが 2,048 バイト未満のときは、一覧に出さない

公式の解説にある「Minify CSS」の説明にも、見込みは CSS の中のコメントと空白をもとにした控えめな値で、minify するツールを使うと見込みより多く減ることがある、と書かれています。

変数の名前を短くする分は見込みに入っていないので、JavaScript は見込みより多く減りました。gzip なしの lodash.js は、見込みどおりに 398,556 バイト減ると 145,542 バイトになる計算ですが、esbuild の --minify では 72,832 バイトになりました。esbuild で空白だけを取り除く --minify-whitespace にすると 147,393 バイトで、Lighthouse の見込みに近い大きさでした。

lodash.js を esbuild で処理したとき 大きさ gzip の後
何もしない 544,098 97,552
空白だけを取り除く 147,393 36,316
空白と、短い書き方への書き直し 144,347 36,019
--minify(名前も短くする) 72,832 26,471

(単位はバイト。gzip はレベル 6 で圧縮した大きさです。)

逆に、gzip で配信するときの CSS は、見込みより減りませんでした。bootstrap.css の見込みは 5,592 バイトでしたが、実際の転送量は 33,507 バイトから 31,020 バイトになり、減ったのは 2,487 バイトでした。Node.js の zlib で比べても、bootstrap.css の gzip の後の大きさは、空白を取り除く前が 33,308 バイト、取り除いた後が 30,903 バイトで、差は 2,405 バイトでした。見込みは minify する前の大きさに対する割合(16.7%)を、gzip の後の転送量にそのまま掛けた値なので、実際の差とずれます。

gzip で配信すると、一覧に出るファイルが変わる

gzip で圧縮するサーバーから元のファイルを配信すると、「Minify JavaScript」の見込みは 401 KiB から 70 KiB になり、一覧から app.js が消えました。

gzipで圧縮するサーバーでのMinify JavaScriptの項目。Est savings of 70 KiBと出ていて、表には/js/lodash.jsだけが95.3 KiBのうち69.8 KiBを減らせると出ている
gzip で圧縮するサーバーでのレポート
console
$ node summarize.mjs out/src-gzip.report.json
lighthouseVersion: 13.6.0  formFactor: mobile  throttling: simulate
performance score: 99  FCP: 1.7 s  LCP: 1.7 s  TBT: 10 ms
unminified-css: score=0.5 scoreDisplayMode=metricSavings title="Minify CSS" displayValue="Est savings of 5 KiB" metricSavings={"FCP":0,"LCP":0}
  /css/bootstrap.css  totalBytes=33507  wastedBytes=5592  wastedPercent=16.7
unminified-javascript: score=0 scoreDisplayMode=metricSavings title="Minify JavaScript" displayValue="Est savings of 70 KiB" metricSavings={"FCP":450,"LCP":450}
  /js/lodash.js  totalBytes=97552  wastedBytes=71458  wastedPercent=73.3

(読み込んだファイルの一覧の行は省いています。)

app.js は minify していないままで、空白とコメントの割合は 65% あります。それでも gzip の後の転送量は 1,489 バイトしかなく、その 65% でも 2,048 バイトに届かないので、一覧に出ませんでした。app.css(477 バイト)が gzip なしでも出なかったのも、同じ理由です。

このため、Lighthouse の一覧に出ていないファイルが minify 済みとは限りません。esbuild で minify すると、app.js は 18,573 バイトから 2,531 バイトになり、gzip の後の転送量も 1,489 バイトから 768 バイトになりました。

ポイント

minify と gzip などの圧縮は、別々に効きます。この検証では、両方を行ったときに転送量がいちばん小さくなりました(CSS と JavaScript の合計で 58,798 バイト)。minify を済ませたら、サーバーが CSS と JavaScript を圧縮して返しているかも、レスポンスの Content-Encoding で確かめておくと安心です。

​Posted by 86