Core Web VitalsのLCPを、preconnectで縮める方法

​​Core Web Vitals​Chrome,HTML,Lighthouse,Playwright,web-vitals

ページ上部の大きな画像(ヒーロー画像)を、画像配信用の別ドメイン(CDN など)から読み込んでいるページがあります。その画像が Core Web Vitals の LCP(Largest Contentful Paint)の要素になっているときは、HTML の <head> に <link rel="preconnect"> を1行書くと、そのドメインとの接続を先に済ませておけます。画像を JavaScript で差し込むページで試したところ、web-vitals で測った LCP の中央値が 1,456ms から 1,064ms に縮みました。Lighthouse のレポートの「Network dependency tree」に「Preconnect candidates」として別ドメインが出たときの直し方です。crossorigin を付けて効かなくなる失敗と、preconnect を足しても変わらなかったページもあわせて載せています。

補足

検証環境は Ubuntu 24.04、Node.js 22、Lighthouse 13.6.0、web-vitals 6.2.3、Playwright 1.63.0 です。ブラウザは Playwright に入っている Chrome for Testing 153 を使いました。ページは http://localhost:8080、画像は https://img.example.com:8443(Chrome の --host-resolver-rules で自分のマシンに向けた名前)から、検証環境で動かした小さなサーバーで配っています。サーバーの前に、データを片道 100ms(往復 200ms)遅らせて渡す中継を置き、接続の最初にも1往復ぶん待たせて、TCP の接続にかかる時間の代わりにしました。DNS の名前解決にかかる時間は再現していません。HTTP/2・HTTP/3 のサーバー、dns-prefetch、HTTP の Link ヘッダーでの preconnect、Chrome 以外のブラウザ、実際の CDN、実際の利用者のデータ(フィールドデータ)は試していません。

検証したページ:画像はJavaScriptが差し込む

検証には、次のようなページを使いました。<head> で CSS とスクリプト vendor.js(約44KB)を読み込み、本文の最後の app.js が、別ドメインのヒーロー画像 hero.jpg(1200×675、約130KB)の <img> を差し込みます。

html
<head>
<!-- meta・title は省略 -->
<link rel="stylesheet" href="/style.css">
<script src="/vendor.js"></script>
</head>
<body>
<h1>猫の手日記</h1>
<div class="hero"></div>
<p>ヒーロー画像は、別のドメイン(img.example.com)から配っています。</p>
<script src="/app.js"></script>
</body>
js
// app.js
const img = document.createElement('img');
img.src = 'https://img.example.com:8443/hero.jpg';
img.alt = 'ヒーロー画像';
img.width = 1200; img.height = 675;
img.fetchPriority = 'high';
document.querySelector('.hero').append(img);

HTML の中に画像の URL はありません。ブラウザが img.example.com に接続しに行くのは、app.js を受け取って実行し、<img> が差し込まれた後です。

中継の遅れは、curl で確かめました。画像のサーバーは TLS 1.3 で、TLS の準備が終わるまでに約 0.4 秒(接続の1往復と、TLS の1往復)かかり、最初の1バイトが届くのは約 0.6 秒後です。

console
$ curl -sk --resolve img.example.com:8443:127.0.0.1 -o /dev/null -w "connect=%{time_connect} tls=%{time_appconnect} ttfb=%{time_starttransfer} total=%{time_total}\n" https://img.example.com:8443/hero.jpg
connect=0.000110 tls=0.403904 ttfb=0.606405 total=0.606525

LighthouseのPreconnect candidatesに別ドメインが出る

このページに Lighthouse を実行しました。結果の JSON から、LCP と「Network dependency tree」の preconnect に関する部分、「LCP breakdown」を、小さなスクリプト(summarize.mjs)で抜き出しています。--chrome-flags の中身(名前の向け先や証明書の設定)は長いので省略しました。

console
$ npx lighthouse http://localhost:8080/js-none.html --only-categories=performance --output=json --output=html --output-path=out/js-none-sim-1 --chrome-flags="(省略)" --quiet
$ node summarize.mjs out/js-none-sim-1.report.json
lighthouseVersion: 13.6.0 throttlingMethod: simulate locale: en-US
performance score: 91
LCP: 3255 ms (3.3 s)
network-dependency-tree-insight: score=0 title="Network dependency tree"
  [Preconnected origins]
    No origins were preconnected
  [Preconnect candidates]
    https://img.example.com:8443  300 ms
lcp-breakdown-insight: title="LCP breakdown"
  Time to first byte: 406 ms
  Resource load delay: 440 ms
  Resource load duration: 610 ms
  Element render delay: 15 ms

「Preconnect candidates」(preconnect の候補)に https://img.example.com:8443 が出て、LCP を 300ms 縮められるという見積もり(Est LCP savings)が付いています。--locale=ja で日本語にすると、項目の名前は「ネットワークの依存関係ツリー」、候補の欄は「事前接続の候補」になりました。

LighthouseのレポートでNetwork dependency treeの項目を開いた画面。Preconnected originsの欄はNo origins were preconnectedで、Preconnect candidatesの表にhttps://img.example.com:8443とEst LCP savings 300 msが出ている
直す前のレポート。別ドメインが preconnect の候補に出る

Chrome の Lighthouse のドキュメントによると、以前の「Preconnect to required origins」の監査は、Lighthouse 13 から Network dependency tree の中に移っています。

直し方:headにpreconnectのlinkを1行足す

<head> の最初のほうに、画像のドメインへの preconnect を1行足しました。href に書くのは、画像の URL ではなく、オリジン(https:// とドメインとポート)です。

html
<link rel="preconnect" href="https://img.example.com:8443">
<link rel="stylesheet" href="/style.css">

MDN の rel="preconnect" の解説によると、preconnect はそのオリジンへの接続の手続きの一部または全部(HTTPS なら DNS・TCP・TLS)を先に済ませておくためのヒントです。同じオリジンへのリクエストは、すでに接続があるので効果がありません。

Chrome を自分で起動して Playwright からつなぎ(この方法を選んだ理由は、最後の節に書きました)、Google の web-vitals ライブラリ(attribution 版)の onLCP で LCP を測りました。あわせて、Chrome DevTools Protocol でリクエストごとの時刻を記録しています。どちらも1回目の記録で、数値はページを開き始めてからのミリ秒です。途中の行は「…」で省略しました。

console
js-none run1: LCP=1456ms url=https://img.example.com:8443/hero.jpg ttfb=408 loadDelay=423 loadDuration=610 renderDelay=15
  ...
  img.example.com:8443/hero.jpg    start=830 connect=831-1236 ssl=832-1236 sendStart=1237 headers=1439 end=1440
  connections accepted: {"page-conn":3,"img-conn":1}
js-preconnect run1: LCP=1068ms url=https://img.example.com:8443/hero.jpg ttfb=403 loadDelay=426 loadDuration=209 renderDelay=30
  ...
  img.example.com:8443/hero.jpg    start=827 connect=828-831 ssl=828-831 sendStart=832 headers=1035 end=1036
  connections accepted: {"page-conn":3,"img-conn":1}

connections accepted は、中継が受けた接続の数です。preconnect がないと、hero.jpg のリクエストが 830ms に始まってから接続と TLS の準備に 405ms かかり、画像のリクエストを送れたのは 1,237ms の時点でした。preconnect を足すと、接続と TLS の準備は 3ms で終わり、リクエストが始まった 827ms の直後、832ms の時点でリクエストを送れています。画像のドメインへの接続は、どちらも1本だけでした。preconnect で作った接続を、画像の取得にそのまま使ったということです。

2つの横棒グラフを縦に並べた画像。上のpreconnectなしでは、hero.jpgの棒の前半に「接続 405ms」のピンクの区間があり、LCPの線が1,456msにある。下のpreconnectありでは、hero.jpgの棒にピンクの区間がなく、LCPの線が1,068msにある
preconnect なし・ありの1回目の、リクエストごとの開始から終了まで(LCP は web-vitals、時刻は CDP の記録)

web-vitals の内訳でも、Resource load duration(画像の取得にかかった時間)が 610ms から 209ms に減っています。Resource load delay(画像を取りに行き始めるまでの待ち)は、どちらも約 420ms で変わりません。preconnect は画像を見つけるタイミングを早めるものではなく、見つけた後の接続の待ちをなくすものだと分かります。

5回ずつ測ったLCP

ブラウザを毎回起動し直して、5回ずつ測りました。

ページ 中央値 最小 最大
preconnect なし 1,456ms 1,456ms 1,468ms
preconnect あり 1,064ms 1,048ms 1,072ms
crossorigin 付きの preconnect 1,456ms 1,456ms 1,464ms

preconnect を足すと、LCP は中央値で 392ms 縮みました。検証環境の中継で入れた遅れ(接続の1往復と TLS の1往復、合わせて約 400ms)が、そのまま短くなった形です。

crossoriginを付けると、preconnectが使われない

表の3行目は、preconnect に crossorigin 属性を付けたページです。

html
<link rel="preconnect" href="https://img.example.com:8443" crossorigin>

LCP は preconnect がないときと同じでした。1回目の記録(途中の行は省略)を見ると、画像のドメインへの接続が2本できていて、hero.jpg は新しい接続で接続と TLS の準備からやり直しています。

console
js-preconnect-crossorigin run1: LCP=1464ms url=https://img.example.com:8443/hero.jpg ttfb=404 loadDelay=431 loadDuration=609 renderDelay=20
  ...
  img.example.com:8443/hero.jpg    start=834 connect=835-1238 ssl=835-1238 sendStart=1238 headers=1441 end=1442
  connections accepted: {"page-conn":3,"img-conn":2}

web.dev の preconnect の解説では、フォントのように CORS で読み込むリソースには、preconnect に crossorigin を付ける必要があるとされています。この検証の <img> は crossorigin を付けずに読み込んでいるので、crossorigin 付きで作った接続は使われませんでした。<img> に crossorigin を付けていないなら、preconnect にも付けないでください。

Lighthouse は、この間違いを見つけてくれます。「Preconnected origins」の欄に、使われなかった preconnect への警告が出ました(前半の行は省略)。

console
$ node summarize.mjs out/js-preconnect-crossorigin-sim-1.report.json
...
  [Preconnected origins]
    https://img.example.com:8443/  <link rel="preconnect" href="https://img.example.com:8443" crossorigin="">
      warning: Unused preconnect. Check that the crossorigin attribute is used properly.
  [Preconnect candidates]
    https://img.example.com:8443  300 ms
LighthouseのNetwork dependency treeの項目。Preconnected originsの表にcrossorigin付きのlink要素があり、その下にUnused preconnect. Check that the crossorigin attribute is used properly.と出ている。Preconnect candidatesにはhttps://img.example.com:8443が残っている
crossorigin を付けた preconnect は使われず、警告が出る

日本語のレポートでは「未使用の事前接続。crossorigin 属性が適切に使用されていることを確認してください。」という警告でした。preconnect を書いたのに候補の欄から消えないときは、この警告がないかを見てください。

注意

web.dev の解説によると、ブラウザは 10 秒以内に使われなかった接続を閉じます。preconnect は、すぐに使う大事なドメインだけに書いてください。

画像がHTMLに書いてあると、preconnectでは変わらなかった

app.js で差し込むのをやめて、<img> を HTML に直接書いたページでも、preconnect のあり・なしを5回ずつ測りました。

console
html-none median: 1048ms (min 1044, max 1060)
html-preconnect median: 1048ms (min 1044, max 1056)

LCP はどちらも 1,048ms で、差がありません。1回目の記録では、hero.jpg のリクエストは HTML を受け取った直後(preconnect なしで 419ms、ありで 410ms)に始まり、その場で接続を作っていました(行の後半は省略)。

console
html-none run1: LCP=1044ms ...
  img.example.com:8443/hero.jpg    start=419 connect=422-826 ssl=422-826 sendStart=826 headers=1029 end=1030
html-preconnect run1: LCP=1044ms ...
  img.example.com:8443/hero.jpg    start=410 connect=421-825 ssl=421-825 sendStart=826 headers=1027 end=1028

web.dev の preload scanner の解説によると、ブラウザには、HTML の解析がスクリプトや CSS で止まっている間も、受け取った HTML を先読みしてリソースを探す仕組み(preload scanner)があります。JavaScript で差し込むリソースは、この仕組みからは見えません。画像を見つけるのが早ければ、preconnect で前倒しできる時間はほとんど残っていません。preconnect が効くのは、この記事のページのように、画像の URL が分かるのが遅い場合です。HTML に <img> を直接書いたページの LCP(中央値 1,048ms)は、JavaScript で差し込んで preconnect を足したページ(1,064ms)とほぼ同じでした。この検証では、画像を HTML に書いただけで、preconnect を足したときと同じくらいの LCP になりました。

Lighthouseの既定の設定では、LCPの数値に差が出なかった

ここまでの数値は web-vitals で測ったものです。Lighthouse を既定の設定(simulate)で3回ずつ実行すると、LCP は preconnect のあり・なしでほとんど同じでした。

ページ 1回目 2回目 3回目
preconnect なし 3,255ms 3,251ms 3,301ms
preconnect あり 3,342ms 3,253ms 3,248ms

simulate は、回線を遅くせずに読み込んだ記録から、遅い回線での読み込みを計算で見積もる設定です(Lighthouse のスロットリングの説明)。この検証では、LCP の数値に preconnect の効果は出ませんでした。一方で、「Preconnect candidates」の欄は、preconnect を足すと「No additional origins are good candidates for preconnecting」に変わり、候補から消えました。

--throttling-method=provided を付けると、Lighthouse は回線や CPU を遅くする処理をせずに測ります(Lighthouse の README の CLI の説明)。中継の遅れがそのまま入るこの検証環境では、web-vitals と同じくらいの差が出ました。

ページ 1回目 2回目 3回目
preconnect なし 1,484ms 1,474ms 1,505ms
preconnect あり 1,058ms 1,081ms 1,105ms
crossorigin 付きの preconnect 1,477ms 1,503ms 1,503ms

ただ、provided で実行したレポートでは、preconnect がないページでも「Preconnect candidates」に候補が出ませんでした(「No additional origins are good candidates for preconnecting」)。候補を探すときは既定の設定のレポートを、効果の大きさを見るときは web-vitals などの実測を見る、と使い分けると迷いません。

Playwrightのchromium.launch()では、preconnectが使われなかった

測定の準備の段階で、Playwright の chromium.launch() で起動したブラウザでは、preconnect が効かないことに気づきました。起動のしかたとブラウザコンテキストを変えて、preconnect を書いたページを開き、hero.jpg の接続と TLS の準備にかかった時間を比べた結果です。

console
$ node context-check.cjs
chromium.launch({ channel: undefined }) + newContext(): hero.jpg connectionReused=false connect=406ms ssl=406ms  connections accepted: {"page-conn":3,"img-conn":1}
chromium.launch({ channel: 'chromium' }) + newContext(): hero.jpg connectionReused=false connect=424ms ssl=424ms  connections accepted: {"page-conn":3,"img-conn":1}
Chrome を自分で起動 + connectOverCDP + contexts()[0] run1: hero.jpg connectionReused=false connect=3ms ssl=3ms  connections accepted: {"page-conn":3,"img-conn":1}
Chrome を自分で起動 + connectOverCDP + contexts()[0] run2: hero.jpg connectionReused=false connect=4ms ssl=4ms  connections accepted: {"page-conn":3,"img-conn":1}
Chrome を自分で起動 + connectOverCDP + newContext() run1: hero.jpg connectionReused=false connect=405ms ssl=405ms  connections accepted: {"page-conn":3,"img-conn":1}
Chrome を自分で起動 + connectOverCDP + newContext() run2: hero.jpg connectionReused=false connect=404ms ssl=403ms  connections accepted: {"page-conn":3,"img-conn":1}

chromium.launch() で起動したときと、browser.newContext() で作ったコンテキストで開いたときは、接続の準備に約 400ms かかっていて、preconnect がないページと同じです。preconnect が効いたのは、Chrome を --remote-debugging-port を付けて自分で起動し、chromium.connectOverCDP() でつないで、最初からあるコンテキスト(browser.contexts()[0])でページを開いたときだけでした。この記事の web-vitals の測定も、この方法で行っています。

どの場合も connectionReused は false でした。preconnect の接続を使ったかどうかは、connectionReused ではなく、接続と TLS の準備にかかった時間が数ミリ秒か、接続の時刻そのものが出ないかで見分けてください(web-vitals で測った、preconnect ありのページの4回目と5回目は、接続の時刻が出ませんでした)。Playwright で preconnect の効果を測るときは、まずこの時間を見て、preconnect が本当に使われているかを確かめてから LCP を比べると、効果がないという誤った結論を避けられます。

​Posted by 86