本文へ移動

k8o

お問い合わせ

255文字以内で入力してください

GitHub Issueからのお問い合わせもお待ちしております。

Blog

公開: 2025年12月30日(火)更新: 2026年11月9日(月)約9分で読めます

LargestContentfulPaintでLCPを測り要素を調べる

LargestContentfulPaintは、画面で一番大きな画像やテキストが描かれた時刻と要素を返すAPIです。ユーザーの環境でLCPを測り、どの要素が遅いかを調べられます。Baseline 2025で使えます。

Newly availableLargest contentful paint (LCP) performance entries2025年〜
  • Chrome77
  • Edge79
  • Firefox122
  • Safari26.2

はじめに

LargestContentfulPaint(Largest Contentful Paint API)は、ページを開いてから、画面に見えている中で一番大きな画像やテキストのブロックが描かれた時刻と、その要素を返すAPIです。Core Web VitalsのLCP(Largest Contentful Paint)は、この時刻を読み込みの速さの指標にしたものです。Safari 26.2が対応して、Baseline 2025に入りました。

手元で一度測るときは、Chrome DevToolsのPerformanceパネルやLighthouseを使います。実際のユーザーの環境でLCPを集めたいときや、どの要素がLCPになったかをページのコードから調べたいときに、このAPIを使います。

基本的な使い方

PerformanceObserverでLCPのエントリを受け取ります。

js
const observer = new PerformanceObserver((list) => {
  const entries = list.getEntries();
  // 最後のエントリが最終的なLCP
  const lastEntry = entries[entries.length - 1];

  console.log(`LCP: ${lastEntry.startTime}ms`);
  console.log(`要素: ${lastEntry.element?.tagName}`);
  console.log(`サイズ: ${lastEntry.size}px²`);

  if (lastEntry.url) {
    console.log(`リソースURL: ${lastEntry.url}`);
  }
});

observer.observe({ type: 'largest-contentful-paint', buffered: true });

開いているページのDevToolsのコンソールにこのコードを貼ると、そのページを読み込んだときのLCPの時刻と要素、面積が出ます。buffered: trueを付けているので、読み込みが終わった後に貼っても、それまでに記録されたエントリが届きます。TypeScriptではgetEntries()がPerformanceEntryの配列を返すので、list.getEntries() as LargestContentfulPaint[]と型を絞ってからelementやsizeを読みます。

下の例は、結果の欄の文書を読み込んだときのLCPの候補を、届いた順に表示します。最初のテキストが1つ目の候補になり、1秒後に描く大きなテキストが2つ目の候補として届きます。やり直すと、文書を読み込み直して測り直します。Safari 27.2は、結果の欄のようなiframeの中の文書にはエントリを届けないので、候補は出ません。

html
<p class="first">最初に描かれるテキスト</p>
<p>届いたLCPの候補</p>
<ol id="entries"></ol>
結果

LCPが確定するとき

PerformanceObserverには複数のentryが届きます。ページの読み込みが進むにつれて、一番大きな要素が変わるからです。最初は小さなテキストが一番大きくても、後から大きな画像が読み込まれると、その画像の要素が新しいentryとして届きます。

つまり、LCPは届いたentryの最後のものです。ただし、いつ最後になったかはページの側からは分かりません。

js
let lcpValue = 0;

const observer = new PerformanceObserver((list) => {
  const entries = list.getEntries();
  const lastEntry = entries[entries.length - 1];
  lcpValue = lastEntry.startTime;
});

observer.observe({ type: 'largest-contentful-paint', buffered: true });

// ユーザーの最初の操作でLCPを確定
const controller = new AbortController();
for (const type of ['keydown', 'pointerdown']) {
  window.addEventListener(type, () => {
    console.log(`最終LCP: ${lcpValue}ms`);
    observer.disconnect();
    controller.abort();
  }, { signal: controller.signal });
}

ここでは、ユーザーの最初のクリックやキー入力でLCPを確定しています。ブラウザも、最初の操作の後は新しいentryを報告しません。どのブラウザでも、ボタンをクリックした後にもっと大きな要素を足しても、entryは届きません。

そのため、SPAでリンクをクリックし、文書を読み込まずにページを移ったときも、移った先のページのLCPは届きません。buffered: trueでobserveし直すと、届くのは文書を読み込んだページのentryです。

対象の要素とプロパティ

LCPの候補になるのは、次の要素です。

  • img要素
  • svgの中のimage要素
  • video要素
  • background-imageで画像を付けた要素
  • p要素などのテキストを含む要素

entryから読む値は、次のとおりです。

  • startTime:LCPの時刻。renderTimeが0でなければrenderTime、0ならloadTime
  • renderTime:要素が描かれた時刻
  • loadTime:リソースの読み込みが終わった時刻。テキストの要素では0
  • size:要素の見えている部分の面積(平方ピクセル)
  • element:LCPの候補になった要素
  • url:画像などのリソースのURL
  • id:要素のid属性の値。無ければ空文字列

Timing-Allow-Originヘッダーの無い別のオリジンの画像でも、renderTimeには少し粗くした時刻が入ります。どのブラウザでも0にはなりません。正確な時刻が要るときは、画像を返すサーバーでTiming-Allow-Originを付けます。

どのブラウザでも、entryを受け取った後にその要素をDOMから消すと、elementはnullになります。Shadow DOMの中の画像は、ChromeとFirefoxではelementがnullのentryとして届き、Safariではentryになりません。

おわりに

LargestContentfulPaintを使うと、一番大きな要素が描かれた時刻とその要素を、ページのコードから受け取れます。候補が変わるたびにentryが届き、最初の操作で報告が止まるので、その時点で最後のentryをLCPとして扱います。