LighthouseのLegacy JavaScript:何を修正し、何を残すべきか

古いブラウザ向けのコードを、すべての訪問者がダウンロードしています。Lighthouseが指摘しているのは誰のファイルなのか、そしてWordPress、Shopify、Next.js、自前のビルドでどう対応すべきかを説明します。

Arjen Karel
更新日 · 8 分で読めます
共有

Legacy JavaScriptは修正すべきでしょうか?

Lighthouseでは、以前「Avoid serving legacy JavaScript to modern browsers」と表示されていた箇所に、現在は「Legacy JavaScript(ポリフィルやトランスパイルによって、古いブラウザでも新しいJavaScript機能を利用できるようにします)」と表示されます。ここには、ほぼ誰も使っていないブラウザ向けのコードを含むスクリプトが列挙されます。そして、すべての訪問者がそのコードをダウンロードしています。自前のJavaScriptであれば、Baseline Widely available対応のブラウザ向けにビルドして修正してください。プラグインや外部ベンダーのファイルは、アップデートするか、置き換えるか、あるいはそのままにしておきます。

手早く解決したい場合は、WordPress、Shopify、Next.js、または自前のビルドへ進んでください。

Legacy JavaScriptは何を検出しているのでしょうか?

警告には次のように記載されています。「ポリフィルやトランスパイルによって、古いブラウザでも新しいJavaScript機能を利用できるようになります。ただし、その多くは最新ブラウザには不要です。古いブラウザのサポートが必須である場合を除き、Baselineの機能をトランスパイルしないようJavaScriptのビルドプロセスを変更することを検討してください。」

Lighthouse report, Legacy JavaScript in red with Est savings of 22 KiB and the labels FCP, LCP and Unscored; the script booking.legacy.js with 22.0 KiB wasted bytes and under it 18 lines such as @babel/plugin-transform-classes, Array.from and Object.entries

PageSpeed Insightsと同じ設定で計測した、フェリー会社のテストページの予約ウィジェット。1つのスクリプトで22 KiBを占めています。

Lighthouseはスクリプトをドメインごとにグループ化し(自前のスクリプトなら「1st Party」、外部ベンダーなら企業名)、それぞれに「Wasted bytes(無駄なバイト数)」を表示します。各スクリプトの下にあるArray.prototype.findやObject.entriesといった機能名の行は、ポリフィルです。その機能を持たないブラウザに対して機能を追加するコードを指します。@babel/plugin-transformで始まる行はトランスフォーム(構文変換)です。ファイルをビルドしたツールであるBabelが、クラスやasync関数などのモダンなコードを、ヘルパー関数を用いた古いJavaScriptに書き換えたことを示しています。

表示されるキロバイト数は推定値であり、ファイル自体のサイズより大きくなることがあります。単一の機能に対するわずかなfallbackであっても、代表的なポリフィルライブラリであるcore-jsの共通ベースコードを丸ごと含んでいるものとして計算されるためです。そのため、ダウンロードサイズが4 KiBのファイルでも10 KiBと表示されることがあります。

赤色は、検出されたスクリプトが最大視覚要素(LCP)や最初のコンテンツ(FCP)と同時にダウンロードされていることを意味します。オレンジ色は、単にファイルサイズを増やしているだけであることを示します。Unscored(スコア対象外):Legacy JavaScript自体はPerformanceスコアの計算対象外ですが、LCPとFCPはスコアに直結します。

レガシーなJavaScriptは訪問者にどう影響するのでしょうか?

予約フォーム、メニュー、スライダーなど、スクリプトが生成するUIの表示を訪問者は余分に待たされることになります。ブラウザに必要な機能がすべて最初から備わっていても、余分なコードをダウンロードして実行してしまうからです。各ポリフィルは機能の有無をチェックし、ブラウザ組み込みの機能があればそれを使いますが、そのためのデータ転送と判定処理はページを読み込むたびに必ず発生します。

あるカーフェリー会社のホームページを模したテストページで、同じコードからReactの予約ウィジェットを2通りビルドしました。1つはBabelとcore-jsを使ったInternet Explorer 11向け、もう1つは最新ブラウザ向けです。どちらもミドルレンジ端末のCPUと、同じモバイル回線(往復時間 150 ms、1.6 Mbps)の環境で実行しました。

ビルド予約フォームの画面表示JavaScript(gzip)スクリプト実行時間
Internet Explorer 11向け1.93秒83 kB80 ms
最新ブラウザ向け1.73秒49 kB50 ms
Phone screen 1.8 seconds after the tap with the Internet Explorer 11 build: the ferry page's heading, no photo yet and a grey placeholder where the booking form goes

改善前

The same moment with the build for current browsers: the car deck photo and the booking form with route, date and passengers

改善後

訪問者がリンクをタップしてから1.8秒後のフェリーのページ。

スクリプト1本だけで0.2秒の差が生じ、そのうち30 msは実行時間によるものです。deferで遅延させたスクリプトであっても、ページ上部の画像とネットワーク接続を共有するため、今回のテストでは警告が赤色になりました。core-js全体を含んだバンドルや、こうしたバンドルを複数読み込んでいるページでは、このウィジェット以上に膨大な無駄コードを抱えることになります。

Lighthouseが指摘しているのは誰のファイルでしょうか?

レポートに表示されているファイルのアドレスを確認すれば、誰がビルドしたファイルなのかがわかります。それによって取れる対策が決まります。

  • 自前のバンドル: 開発者がビルドしているテーマやアプリです。ビルド設定を1箇所変更して再ビルドしてください(自前のビルド)。
  • プラグインのスクリプト: WordPressの場合、アドレス内の/wp-content/plugins/に続くフォルダ名がプラグイン名です。Lighthouseには、MonsterInsightsのfrontend-gtag.min.js、商品ページや注文手続きページにおけるWooCommerceのStripe決済ゲートウェイ、フォームプラグインの日付ピッカー(WPForms、Ninja Forms、Elementor内のflatpickrなど)がリストアップされます。wp-polyfill.min.jsはWordPress本体のファイルですが、WooCommerceのブロックや、reCAPTCHAを有効にしたContact Form 7など、プラグインからの要求に応じて読み込まれます(WordPress)。
  • 外部ベンダーのタグ(企業名で表示): Meta Pixel(fbevents.js)、OneTrustのクッキーバナー、HubSpotのフォームやフィードバック用スクリプト、Cloudflareがページに自動挿入するCloudflare Web Analyticsのビーコンなどが該当します。Google Tag Managerとgtag.jsは一覧には表示されません。これらのファイルを再ビルドできるのはベンダー側だけです。タグを残すか、削除するかの二者択一になります。Cloudflare Web Analyticsは、Cloudflareのダッシュボードで無効化できます。
  • Next.js: Next.jsを採用しているサイトでは例外なく、Array.prototype.atやObject.hasOwnといったNext.js独自のポリフィルを含むスクリプトが検出されます。
Lighthouse report, Legacy JavaScript in orange with Est savings of 11 KiB: only Facebook's fbevents.js from connect.facebook.net with 10.9 KiB and eight lines, the three Babel transforms and Array.from, filter, find, map and String.prototype.startsWith

最新ブラウザ向けにビルドし、Meta Pixelを追加したフェリーのページ。Facebookのファイルだけが残っています。

Legacy JavaScriptはどう修正すればよいでしょうか?

まずは自身でコントロールできる最も大きなファイルから着手し、次に全ページで古いコードを読み込んでいるプラグインやアプリに対処します。

WordPress

まずはWordPressとプラグインをアップデートしてください。新しいバージョンであれば、最新ブラウザ向けにビルドされている可能性があります。その上で、リストアップされたファイルごとに次の対応を行います。

  • 全ページでは不要なプラグイン: フォームプラグインの日付ピッカーや決済ゲートウェイのスクリプトは、それらを使用するページでのみ読み込むべきです。Asset CleanUp(メニューの「Asset CleanUp」>「CSS & JS Manager」)やPerfmattersのScript Managerを使い、それ以外のすべてのページで読み込みを解除(アンロード)してください。
  • 代替手段があるプラグイン: MonsterInsightsのようなアクセス解析プラグインが独自の検出対象スクリプトを全ページで読み込んでいる場合は、Site Kit by GoogleのようにGoogle公式のタグのみを追加するプラグインへ切り替えてください。
  • wp-polyfill: Query Monitorプラグインを使えば、これに依存しているスクリプトを特定できます。原因となっているプラグインを見つけ、お問い合わせページにおけるContact Form 7のreCAPTCHAのように、必要なページでのみ読み込むように設定してください。なお、前述のツールでwp-polyfill自体をアンロードしたり、コードで登録解除(deregister)したりしてはいけません。WordPressはそれに依存するすべてのスクリプトの読み込みを警告なしに停止してしまいます。WooCommerceサイトの場合、ミニカート、カート、チェックアウトの機能が動作しなくなります。

WP Rocketの「Delay JavaScript execution」機能を使えば警告自体は消えますが、訪問者が最初のタップやスクロールを行った時点で、結局同じコードがダウンロードされて実行されます。

Shopify

リストアップされたファイルは、アプリ、テーマに貼り付けられたタグ、またはカスタムテーマ独自のスクリプトのいずれかに起因します。アプリを更新するかベンダーに最新ビルドの提供を依頼し、不要になったアプリは削除してください。カスタムテーマの場合は、開発者にビルド設定の項目を参照してもらってください。

Next.js

Next.jsはデフォルトで独自コードを最新ブラウザ向けにビルドします。package.jsonにbrowserslistが設定されていればそれに従います。Next.js自身が追加するポリフィルを削除する設定は存在しません。この行はそのままにしておきます。

自前のビルド

サポートするブラウザをビルドツールに指定し、ポリフィルの追加を停止してください。Baseline Widely availableとは、すべての主要ブラウザが少なくとも30か月以上にわたってサポートしている機能群のことです。クラス構文やasync関数を実行できないブラウザを使っている訪問者は、世界全体で見ても約0.2%にすぎません。切り替える前に、iOS 15や16で更新が止まっている古いiPhoneの割合をアナリティクスで確認してください。package.jsonには次のように記述します。

"browserslist": [
  "baseline widely available"
]

これにはbrowserslist 4.26以降が必要です。Babel 7をお使いの場合は、@babel/preset-envからuseBuiltIns、corejs、targetsを削除し、エントリファイルにimport "core-js/stable"の記述があればそれも削除します。

// babel.config.js
module.exports = {
  presets: ['@babel/preset-env']
};

targetsを指定しない場合、Babelはpackage.jsonのbrowserslistを読み込みます。対象ブラウザが非対応の構文のみを書き換え、ポリフィルは一切追加しなくなります。Babel 8ではuseBuiltInsとcorejsが廃止されました。また、Vite、esbuild、webpack自体はポリフィルを追加しません。webpackビルドでポリフィルが混入するのはbabel-loaderが原因であるため、上記のBabel設定変更でカバーできます。ViteもデフォルトでBaseline Widely available向けにビルドされます。

再ビルド後もリストに残る行がある場合、それはnode_modules内のパッケージ独自に古いビルドが施されていることが原因です。そのパッケージをアップデートするか、別のパッケージに置き換えてください。

その後、前回と同じ方法で再度Lighthouseを実行してください。「No legacy JavaScript found」と表示されるか、自身でビルドしていないファイルのみがリストアップされるようになります。

ページ内でまったく使用されていないスクリプトについては、別の警告であるReduce unused JavaScriptで扱われます。

Legacy JavaScriptをレポートに残したままでよいのはどんな場合でしょうか?

検出されている項目がNext.js独自のポリフィルである場合や、代替が利かない必須の外部ベンダー製タグであり、かつ警告がオレンジ色にとどまっている場合は、そのままにしておいて構いません。数十KiB規模に達する自前のバンドルである場合や、警告が赤色になっている場合は修正が必要です。赤色の場合、ファイルがLCP要素と同時にダウンロードされていることを意味し、ファイルサイズを小さくすればその要素の表示タイミングを早めることができます。軽量化できない外部ベンダーのタグは、LCP要素が読み込まれた後に実行開始を遅らせてください(スクリプトの読み込みを遅延させる手法)。

10個の外部タグと20個のプラグインを抱えているようなサイトでは、別の観点での検討が求められます。そもそも各ページでそれらのスクリプトが本当に必要なのか、という点です。power hourでは、対象ページの実際のレポートを確認しながら、リストアップされたスクリプトのうちどれを残し、どのページで読み込むべきかを判断します。

About the author

Arjen Karel is a web performance consultant and the creator of CoreDash, a Real User Monitoring platform that tracks Core Web Vitals data across hundreds of sites. He also built the Core Web Vitals Visualizer Chrome extension. He has helped clients achieve passing Core Web Vitals scores on over 925,000 mobile URLs.

Arjen Karel

サイトをもっと速くしたいですか?

Arjenです。17年間、遅いサイトを直してきました。ご自身で解決できない問題があれば、URLをお送りください。一度お話ししましょう。

URLを送る
Arjen Karel
Arjen Karel, 2009年から活動するWebパフォーマンスコンサルタント

なぜ修正が効かないのか?

CDNがまだ古いHTMLを配信している、あるいは修正がデスクトップ用テンプレートにだけ入り、モバイルは別のテンプレートを使っている、ということがあります。URLと問題をお送りいただければ、候補の日時をご返信します。まずfield dataを確認し、1時間サイトを一緒に見て、1日以内に調査メモを書面でお送りします。€350(税別)。

URLを送る

修正を実装する開発者がいませんか? サイトのコピー上で私が作業します。

Arjen KarelモバイルのCore Web Vitalsがまだ赤いままですか?URLを送る