このページは Cloud Translation API によって翻訳されました。

新しいソフトナビゲーションのオリジントライアル

Barry Pollard

Michal Mocny

公開日: 2025 年 7 月 31 日

Chrome 139 から、以前に試験運用を行っていた Soft Navigations API の新しいオリジントライアルが開始されます。このオリジントライアルでは、サイトで実際のユーザーを対象に API を試して、API のフィールドテストを実施し、Chrome チームにフィードバックを提供できます。

ソフトナビゲーションとは

ソフトナビゲーションとは、JavaScript がナビゲーション（リンクのクリックなど）をインターセプトし、新しいページを読み込むのではなく、既存のページのコンテンツを更新するものです。その後、アドレスバーの URL が更新されます（履歴状態により、前後のソフトナビゲーションが可能になります）。ユーザーには従来のナビゲーションと同じように見えますが、ブラウザから見るとページは元のページです。

ソフトナビゲーション API が必要な理由

Soft Navigations API は、シングルページアプリケーション（SPA）サイトで使用されるいわゆる「ソフトナビゲーション」をヒューリスティックベースで検出できるようにする API として提案されています。ソフトナビゲーションでは実際のページナビゲーションは発生しないため、通常ナビゲーションで発生する特定のアクションは JavaScript で手動で管理する必要があります。ナビゲーション履歴の管理など、一部のアクションは現在の API で可能です。ただし、これらのナビゲーションでは、Core Web Vitals の測定などの他のアクションは実行できません。

Soft Navigation API を使用すると、ソフトナビゲーションを監視できます。ソフトナビゲーションを開始する JavaScript（通常は JavaScript フレームワーク）はナビゲーションの発生を認識しますが、他の JavaScript やブラウザ自体は認識しません。

Core Web Vitals と SPA

Soft Navigation API の主な目的の一つは、SPA のウェブに関する主な指標を測定できるようにすることです。ウェブに関する主な指標は、ブラウザ（Chrome ユーザーエクスペリエンスレポートなどのツールに表示される）と、リアルユーザーモニタリング（RUM）JavaScript ライブラリの両方で測定されます。

JavaScript フレームワークでは、ウェブに関する主な指標の一部を測定できます。特に Interaction to Next Paint（INP）と Cumulative Layout Shift（CLS）は、任意の期間で測定して INP 指標と CLS 指標を計算できるプリミティブ（それぞれ Event Timing API と Layout Instability API）に基づいています。ただし、Largest Contentful Paint（LCP）などの他の指標は、ブラウザによってのみ出力されます。これは、ページナビゲーションに基づいており、インタラクション時に確定されます。

Soft Navigation API で SPA のウェブに関する主な指標を測定する方法

Soft Navigation API の最初のイテレーションでは、ソフトナビゲーションヒューリスティクスと LCP のリセットが組み合わされていました。リセット後、新しいコンテンツフルペイントのソフトナビゲーションで LCP を再発行できるようになり、ソフトナビゲーションのこの指標を測定できるようになります。

この最新のイテレーションでは、異なるアプローチを採用し、これらのコンセプトを Soft Navigation API と新しい Interaction to Contentful Paint パフォーマンスエントリに分離しています。interaction-contentful-paint エントリは、インタラクション後の「コンテンツフルペイント」を測定します。現時点では、これはソフトナビゲーションでのみ出力されますが、すべてのインタラクションで有効にすると、LCP 以外のユースケースにも対応できるようになります。

また、API は largest-contentful-paint、interaction-contentful-paint、event-timing、layout-shift の各パフォーマンスエントリを拡張し、エントリが対象とするナビゲーションの識別子を含めるようにしました。パフォーマンスエントリは、測定対象のイベントの後に（通常はアイドル時間中に）出力されます。つまり、パフォーマンスエントリが出力されるまでに URL が変更されていることがよくあります。エントリにナビゲーションを含めることで、パフォーマンスエントリの時刻とソフトナビゲーションエントリの時刻を照合することなく、特定の URL のウェブに関する主な指標を簡単に測定できるようになります。

なぜヒューリスティックを使用するのか

Soft Navigation API は、次の条件が満たされた場合にソフトナビゲーションとみなします。

ユーザーベースのインタラクションが発生する（ユーザーの操作なしで URL が更新された場合はカウントされません）
… これにより、DOM の変更とペイントが発生します。
… URL の更新が発生する
URL の更新（履歴の変更を含む）。

この API は、JavaScript フレームワークがソフトナビゲーションを「発行」したり、Navigation API をベースに構築したりすることを許可するのではなく、ヒューリスティックベースのアプローチを採用しています。これにより、フレームワークやデベロッパーの使用方法に関係なく、ソフトナビゲーションを構成する要素を常に把握できます。

フレームワークやデベロッパーは、ユーザーがナビゲーションと認識するユーザー操作や DOM の更新がなくても、ソフトナビゲーションの URL を更新できます。また、URL の更新のタイミングも、やり取りの開始時、完了時のみ、またはその間の任意のタイミングなど、さまざまです。

フレームワークの選択に依存するのではなく、ブラウザにソフトナビゲーション検出を組み込むことで、標準的な「ヒューリスティック」（このオリジントライアルからのフィードバックを含む）が確立され、ソフトナビゲーションの Core Web Vitals を大規模に測定し、そのような測定値を大規模に比較できるようになります。

フレームワークとデベロッパーは、Soft Navigations API のヒューリスティックを無視して、基盤となる Event Timing、Layout Instability、Interaction to Contentful Paint の各 API を使用して、必要に応じて追加のパフォーマンス指標を測定することもできますが、サイト全体で測定できるように、ヒューリスティックを使用する Core Web Vitals をおすすめします。

ソフトナビゲーション API のテストにご協力ください

ソフトナビゲーション API をテストして、ソフトナビゲーションが発生したタイミングに関するヒューリスティックが期待どおりに機能するかどうかを確認する必要があります。ソフトナビゲーションが発生したとみなされる場合に、API がソフトナビゲーションを報告しないことはありますか？逆に、ソフトナビゲーションと見なさないナビゲーションを API が繰り返すことはありますか？

問題を引き起こす例としては、履歴を追加する代わりに replaceState で URL を更新した場合や、ユーザーが開始したものではないナビゲーションが発生した場合（タイムアウト時のログアウトなど）があります。どちらのケースもヒューリスティックに一致しないことで説明できます。Chrome チームはこれらを含めないことに同意していますが、ウェブデベロッパーの皆様のご意見をお聞かせください。特に、ヒューリスティックが満たされているように見えるにもかかわらず、API がソフトナビゲーションを認識しないケースについてお聞かせください。

また、この API と新しい Interaction to Contentful Paint プリミティブが、SPA のウェブに関する主な指標の測定を可能にするという主なユースケースに対応しているかどうかについても把握したいと考えています。

API をできるだけ有用なものにしたいと考えています。サイトが実装に依存し始める前に、API を有用なものにする方がはるかに簡単です。そのため、SPA デベロッパーや、こうしたサイトのウェブパフォーマンスの測定に関心をお持ちの方には、ぜひこの API をお試しいただき、その結果をお知らせいただきたいと思います。

テスト方法

この API は、Chrome のフラグまたはコマンドラインオプションを使用してローカルでテストできます。また、オリジントライアルでフィールドテストを行うこともできます。

API の技術的な詳細、特にコアウェブバイタルの測定方法については、ドキュメントまたは GitHub リポジトリをご覧ください。また、試験運用版のウェブに関する主な指標ライブラリのソフトナビゲーションバージョンも利用できます。

フィードバック

このテストに関するフィードバックは、以下の場所で積極的に募集しています。

API に関するフィードバックは、GitHub の問題として報告してください。
Chromium 実装のバグは、まだ既知の問題でない場合は、Chrome の問題トラッカーで報告する必要があります。
ウェブバイタルの一般的なフィードバックは、web-vitals-feedback@googlegroups.com までお送りください。

どちらにすべきか迷った場合は、あまり心配しないでください。どちらの場所でもフィードバックをお寄せいただければ、両方の場所で問題をトリアージし、正しい場所に問題をリダイレクトいたします。