PerformanceNavigationTiming

Baseline 広く利用可能 *

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2021年10月以降、すべてのブラウザーで利用可能です。

* この機能の一部は、対応レベルが異なる場合があります。

PerformanceNavigationTiming インターフェイスは、ブラウザーの文書ナビゲーションイベントに関するメトリックを格納および取得するためのメソッドとプロパティを提供します。たとえば、このインターフェイスを使用して、文書のロードまたはアンロードにかかる時間を判断できます。

パフォーマンスタイムラインに記載されるのは現在の文書のみなので、パフォーマンスタイムライン内の PerformanceNavigationTiming オブジェクトは 1 つだけです。このオブジェクトは PerformanceResourceTiming と PerformanceEntry のプロパティとメソッドをすべて継承します。

以下は PerformanceNavigationTiming で定義するタイムスタンププロパティをすべて表示させたものです。

文書内の取得したタイムスタンプを記録順に並べたタイムスタンプ図

インスタンスプロパティ

このインターフェイスは、以下の PerformanceEntry プロパティを修飾および制約することで拡張します。

PerformanceEntry.entryType 読取専用: "navigation" を返します。
PerformanceEntry.name 読取専用: 文書の URL を返します。テキストフラグメントおよびその他のフラグメントディレクティブは URL から削除されることに注意してください。
PerformanceEntry.startTime 読取専用: 値 0 を持つ DOMHighResTimeStamp を返します。
PerformanceEntry.duration 読取専用: PerformanceNavigationTiming.loadEventEnd と PerformanceEntry.startTime の各プロパティの差である timestamp を返します。

このインターフェイスは、ナビゲーションパフォーマンス項目型の以下の PerformanceResourceTiming プロパティも、次のように修飾して制約することで拡張します。

PerformanceResourceTiming.initiatorType 読取専用: "navigation" を返します。

このインターフェイスは以下のプロパティにも対応しています。

PerformanceNavigationTiming.activationStart 読取専用: DOMHighResTimeStamp で、文書が事前レンダリングを始めてから有効になるまでの時間を表します。
PerformanceNavigationTiming.criticalCHRestart 読取専用: DOMHighResTimeStamp で、Critical-CH HTTP レスポンスヘッダーの不一致により接続の再開が発生した時刻を表します。
PerformanceNavigationTiming.domComplete 読取専用: DOMHighResTimeStamp で、ユーザーエージェントがこの文書の readyState を "complete" に設定する直前の時刻を表します。
PerformanceNavigationTiming.domContentLoadedEventEnd 読取専用: DOMHighResTimeStamp で、現在の文書の DOMContentLoaded イベントが完了した直後の時間と等しい時間値を表します。
PerformanceNavigationTiming.domContentLoadedEventStart 読取専用: DOMHighResTimeStamp で、現在の文書でユーザーエージェントが DOMContentLoaded イベントを起動する直前の時間と等しい時間値を表します。
PerformanceNavigationTiming.domInteractive 読取専用: DOMHighResTimeStamp で、ユーザーエージェントがこの文書の readyState を "interactive" に設定する直前の時刻を表します。
PerformanceNavigationTiming.loadEventEnd 読取専用: DOMHighResTimeStamp で、現在の文書の load イベントが完了した時刻を表します。
PerformanceNavigationTiming.loadEventStart 読取専用: DOMHighResTimeStamp で、現在の文書の load イベントが発生する直前の時間と等しい時間値を表します。
PerformanceNavigationTiming.notRestoredReasons 読取専用: NotRestoredReasons オブジェクトで、現在の文書がバック/フォワードキャッシュ (bfcache) から復元されなかった理由に関する情報を表します。
PerformanceNavigationTiming.redirectCount 読取専用: 現在の閲覧コンテキストでの最後のリダイレクト以外のナビゲーション以降のリダイレクト数を表す数値。
PerformanceNavigationTiming.type 読取専用: 文字列で、ナビゲーションの種類を表します。 "navigate"、"reload"、"back_forward" のいずれかです。
PerformanceNavigationTiming.unloadEventEnd 読取専用: DOMHighResTimeStamp で、ユーザーエージェントが前の文書の unload イベントを完了した直後の時間と等しい時間値を表します。
PerformanceNavigationTiming.unloadEventStart 読取専用: DOMHighResTimeStamp で、ユーザーエージェントが前の文書の unload イベントを開始する直前の時間と等しい時間値を表します。