Core Web Vitalsに関わるbfcacheが効かない原因の調べ方

​​Core Web Vitals​Chrome,Chrome DevTools,JavaScript,Playwright,web-vitals

ブラウザの「戻る」「進む」で前のページを一瞬で出す仕組みが、bfcache(back/forward cache)です。ページに unload のリスナーがあるなどの理由で bfcache が使えないと、戻ったときにページを読み込み直すことになります。Chrome DevTools の Application パネルにある「Back/forward cache」でテストすると、そのページで bfcache が使えるか、使えないならどこが原因かが一覧で出ます。「ブラウザバックで表示が遅い」「『戻る』で、JavaScript で作った表示が最初からやり直しになる」というときの調べ方として使えます。

ここでは、原因になりそうな書き方を1つずつ入れたページを用意し、DevTools のテストと、Playwright で実際に「戻る」をしたときの結果を並べました。Core Web Vitals を測る web-vitals ライブラリで、戻ったときの LCP がどう報告されるかも載せます。

補足

検証環境は Ubuntu 24.04、Node.js 22、Playwright 1.63.0 に入っている Chrome for Testing 153(ヘッドレス)、web-vitals 6.2.3 です。ページは検証環境で動かした小さなサーバー(localhost:8080、HTTP/1.1)から配りました。DevTools は英語の表示で使っています。Firefox と Safari、Android の Chrome、実際の利用者から集めたデータ(CrUX)は試していません。

DevToolsのBack/forward cacheで、使えない原因を出す

DevTools で確かめる手順は次のとおりです。

  1. 調べたいページを Chrome で開き、DevTools を開く
  2. 「Application」パネルを開き、左の一覧の「Background services」にある「Back/forward cache」を選ぶ
  3. 「Test back/forward cache」のボタンを押す

ボタンを押すと、DevTools がページを別のページへ移してから戻し、bfcache から戻せたかを表示します。DevTools の画面の説明文には、テストのボタンを押すと自動でページを移って戻ってくる、と書かれています。

unload のリスナーを入れたページでテストすると、次のように出ました。

DevToolsのApplicationパネルのBack/forward cacheで、unload.htmlをテストした画面。「Not served from back/forward cache」と出て、Actionableの欄に「The page has an unload handler in the main frame.」と「UnloadHandlerExistsInMainFrame」が表示されている
unload のリスナーがあるページをテストした結果

画面の上のほうに「Not served from back/forward cache」と出て、bfcache から戻せなかったことが分かります。その下の「Actionable」の欄に、原因の説明「The page has an unload handler in the main frame.」と、理由の名前 UnloadHandlerExistsInMainFrame が並びます。

原因は3つの欄に分けて表示されます。DevTools のソースコードにある、この画面の文言では、「Actionable」は直せば bfcache が使えるようになる理由、「Not actionable」はページの側では直せない理由、「Pending support」は、今後の Chrome で対応が進めば bfcache を止めなくなる理由です。まずは「Actionable」に出たものを直します。

bfcache から戻せたページでは、「Successfully served from back/forward cache.」と出ます。

原因になりそうな書き方を1つずつ試した結果

次のページを用意し、DevTools のテストと、Playwright で「次のページへ移る → 戻る」をした結果を比べました。どのページも、見出しと画像とリンクだけの同じ形で、違うのは表の左の列の部分だけです。

ページ DevTools のテスト 「戻る」で表示されたとき
何も入れていない 使えた bfcache から戻った
unload のリスナー UnloadHandlerExistsInMainFrame 読み込み直した
pagehide のリスナー 使えた bfcache から戻った
beforeunload のリスナー 使えた bfcache から戻った
Cache-Control: no-store 使えた bfcache から戻った
unload のリスナーがある同じオリジンの iframe UnloadHandlerExistsInSubFrame 読み込み直した
Cache-Control: no-store で、離れている間に Cookie が変わった (テストのボタンでは試せない) 読み込み直した

Playwright で戻ったかどうかは、pageshow イベントの persisted で確かめました。persisted は、ページがキャッシュから読み込まれたかを表す値です(MDN の persisted の説明)。検証では、bfcache から戻ったときは true、読み込み直したときは false でした。

この表のうち、beforeunload と Cache-Control: no-store は、今回の Chrome 153 では bfcache を止めませんでした。web.dev の bfcache の記事(2026年10月16日更新)では、beforeunload は今のブラウザでは bfcache を止めないものの、以前は止めていて今も当てにならないので、必要なときだけ使うように、と書かれています。no-store については、HTML に付けたページはこれまでブラウザが bfcache に入れてこなかったとされていて、Chrome で変える作業が進んでいる、という書き方です。

unloadのリスナーは、iframeの中にあっても止める

unload のリスナーは、ページの中の iframe にあっても bfcache を止めました。同じオリジンの iframe に unload のリスナーを入れたページでは、理由が UnloadHandlerExistsInSubFrame になります。「1 frame」を開くと、原因になった iframe の URL が出ます。

DevToolsのBack/forward cacheで、iframe-same.htmlをテストした画面。「The page has an unload handler in a sub frame.」と「UnloadHandlerExistsInSubFrame」が出て、「1 frame」を開いた下に http://localhost:8080/child-unload.html が表示されている
iframe の中の unload のリスナーが原因のとき

同じオリジンの iframe なら、この URL を手がかりに、どの部品が原因かを探せます。iframe を別のオリジン(127.0.0.1:8080)から読み込んだ場合は DevTools のテストにかけていませんが、Playwright で戻ったときの理由は同じ UnloadHandlerExistsInSubFrame でした。

なお、検証環境では unload のリスナーは実際に呼ばれました。リスナーの中で navigator.sendBeacon() を呼ぶと、ページを離れたときにサーバーに届きました。MDN の unload イベントの説明には、Chrome は既定で unload を呼ばなくなったと書かれていますが、今回の Chrome for Testing 153 では呼ばれ、bfcache も使われませんでした。

unloadの代わりにpagehideを使う

MDN の unload イベントの説明では、unload の代わりに visibilitychange か pagehide を使うように書かれていて、できれば visibilitychange を使うよう勧めています。ここでは、ページを離れたことを知りたい場合の例として、pagehide に書き換えました。

js
// 書き換える前:bfcache が使えなくなる
addEventListener('unload', () => navigator.sendBeacon('/beacon?from=unload'));

// 書き換えた後
addEventListener('pagehide', (e) => navigator.sendBeacon('/beacon?from=pagehide&persisted=' + e.persisted));

pagehide のリスナーに替えたページでは、DevTools のテストが「Successfully served from back/forward cache.」になりました。

DevToolsのBack/forward cacheで、pagehide.htmlをテストした画面。「Successfully served from back/forward cache.」と表示されている
pagehide に替えたページをテストした結果

Playwright で次のページへ移ったときも、pagehide のリスナーから送ったデータはサーバーに届き、中身は ?from=pagehide&persisted=true でした。persisted が true なのは、ページが捨てられずに bfcache に入ったことを表しています(MDN の pagehide イベントの説明)。

Cache-Control: no-storeは、Cookieが変わると戻せなくなった

HTML の応答に Cache-Control: no-store を付けたページは、今回の Chrome 153 では bfcache から戻りました。Chromium 153.0.8010.12 のソースコードでは、no-store のページを bfcache に入れる機能(kCacheControlNoStoreEnterBackForwardCache)が、既定で有効になっています。同じ箇所のコメントには、Cookie が変わったときに戻すかどうかは、この機能のパラメーターで決まると書かれています。

そこで、次のページで document.cookie を書き換えてから戻ってみました。今度は bfcache から戻らず、HTML をサーバーから取り直しています。Chrome DevTools Protocol の Page.backForwardCacheNotUsed イベントで受け取った理由は、次のとおりです。

console
$ node check.mjs nostore next-cookie
## nostore.html → next-cookie.html → 戻る
log: [{"event":"pageshow","persisted":false},{"name":"LCP","value":640,"navigationType":"back-forward"}]
Page.backForwardCacheNotUsed: [{"type":"PageSupportNeeded","reason":"CacheControlNoStoreCookieModified"}]
notRestoredReasons: {"src":null,"id":null,"url":"http://localhost:8080/nostore.html","name":null,"reasons":[{"reason":"response-cache-control-no-store"}],"children":[]}
beacons: []
次のページへ移ってから後に、サーバーに届いたリクエスト: ["/next-cookie.html","/nostore.html"]

理由は CacheControlNoStoreCookieModified です。一方、同じ no-store のページを DevTools のテストのボタンで試すと、「Successfully served from back/forward cache.」と出ました。ログインしているページのように、no-store を付けていて Cookie がよく変わるページは、DevTools のテストで使えると出ても、実際には戻せないことがあります。

戻ったときのLCPは、web-vitalsで別に報告される

bfcache は Core Web Vitals の値にも関わります。web-vitals の README には、bfcache から戻ったときは、指標がもう一度報告されると書かれています。そのときの navigationType は 'back-forward-cache' です。

検証用のページは、HTML を 600 ミリ秒、LCP の画像を 800 ミリ秒待たせてから返すようにしてあります。web-vitals の onLCP に reportAllChanges: true を付けて、報告された LCP を記録しました(単位はミリ秒、1回ずつ)。

ページ 最初に開いたときの LCP 戻ったときの LCP 戻ったときの navigationType
何も入れていない 1432 13 back-forward-cache
pagehide のリスナー 1440 11 back-forward-cache
unload のリスナー (記録なし) 32 back-forward
no-store で Cookie が変わった (記録なし) 640 back-forward

unload のリスナーと、no-store で Cookie が変わったページは、読み込み直したので、戻ったときには最初に開いたときの記録が消えています。

bfcache から戻ったページは、LCP が 11〜13 ミリ秒でした。一方、bfcache が使えなかった unload のページは 32 ミリ秒で、こちらもほとんど待っていません。サーバーに届いたリクエストを見ると、戻ったときに HTML も画像も取りに来ておらず、ブラウザが手元に残していた HTML と画像を使って表示し直していました。HTML に no-store を付けて Cookie が変わったページは、HTML をサーバーから取り直したため、LCP が 640 ミリ秒になりました。

今回のページは小さく、bfcache が使えなくても手元の HTML と画像で戻りは速いままでした。HTML を取り直した Cookie の変わったページでは、そのぶん LCP が長くなりました。

コードで集めた理由は、maskedで隠れることがある

DevTools のテストは自分の手元で1ページずつ確かめる方法です。実際の利用者のブラウザで原因を集めるには、PerformanceNavigationTiming の notRestoredReasons を使います。MDN の notRestoredReasons の説明では、unload のリスナーが原因なら "unload-listener" が入る例が載っています。

js
const [nav] = performance.getEntriesByType('navigation');
console.log(nav.notRestoredReasons);

ただ、検証環境の unload のリスナーのページでは、次のように "masked" だけが返りました。

console
$ node check.mjs unload
## unload.html → next.html → 戻る
log: [{"event":"pageshow","persisted":false},{"name":"LCP","value":32,"navigationType":"back-forward"}]
Page.backForwardCacheNotUsed: [{"type":"Circumstantial","reason":"BrowsingInstanceNotSwapped"},{"type":"PageSupportNeeded","reason":"UnloadHandlerExistsInMainFrame"}]
notRestoredReasons: {"src":null,"id":null,"url":"http://localhost:8080/unload.html","name":null,"reasons":[{"reason":"masked"}],"children":[]}
beacons: ["?from=unload"]
次のページへ移ってから後に、サーバーに届いたリクエスト: ["/next.html"]

同じときに Page.backForwardCacheNotUsed で受け取った理由には、UnloadHandlerExistsInMainFrame のほかに、ページの側では直せない理由(Circumstantial。DevTools の画面では「Not actionable」の欄)の BrowsingInstanceNotSwapped も入っていました。MDN によると、"masked" は別のオリジンの iframe が原因のときのほか、ブラウザに固有の理由を隠すときにも使われます。iframe の中に unload のリスナーがあるページも、同じオリジンか別のオリジンかに関わらず、"masked" でした。MDN には、同じオリジンの iframe なら children に iframe ごとの理由が入る例がありますが、今回は children は空の配列でした。

一方、no-store で Cookie が変わったページでは、"response-cache-control-no-store" と、理由の名前がそのまま返りました。集めたデータに "masked" が多いときは、そのページを DevTools のテストにかけて、具体的な理由を確かめるのが近道です。

Playwrightでは、bfcacheのテストはサポートされていない

Playwright 1.63.0 の型定義にある page.goBack() の説明には、bfcache のテストはサポートしていないと書かれています。既定で bfcache を無効にしていること、有効にしても page.goBack() が時間切れになり、Page の状態がずれることも書かれています。

検証環境でも、既定の起動では理由に BackForwardCacheDisabledByCommandLine が出て、bfcache は使われませんでした。Playwright のソースコードで既定で付けている --disable-back-forward-cache を外しても、既定の headless shell では BackForwardCacheDisabledForDelegate が出ました。Playwright のドキュメントにある 'chromium' チャンネルで新しいヘッドレスモードにしたときだけ、bfcache から戻りました。

js
const browser = await chromium.launch({
  channel: 'chromium',                                 // 新しいヘッドレスモード
  ignoreDefaultArgs: ['--disable-back-forward-cache'], // Playwright が既定で付ける bfcache の無効化を外す
});

この起動で、待ち方は既定(load)のまま timeout: 10000 を付けて page.goBack() を呼ぶと、ページは bfcache から戻っていても(persisted が true)、10 秒で時間切れになりました。この記事の結果は、page.goBack({ waitUntil: 'commit' }) の後に3秒待ってから値を読み出し、理由は newCDPSession() でつないだ Page.backForwardCacheNotUsed イベントから受け取ったものです。サポート外の使い方なので、確認には DevTools のテストを主に使ってください。

​Posted by 86