PerformanceNavigationTiming

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2021年10月⁩.

* Some parts of this feature may have varying levels of support.

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 読取専用 Experimental: DOMHighResTimeStamp で、文書が事前レンダリングを始めてから有効になるまでの時間を表します。
PerformanceNavigationTiming.criticalCHRestart 読取専用 Experimental: 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 読取専用 Experimental: NotRestoredReasons オブジェクトで、現在の文書がバック/フォワードキャッシュ (bfcache) から復元されなかった理由に関する情報を表します。
PerformanceNavigationTiming.redirectCount 読取専用: 現在の閲覧コンテキストでの最後のリダイレクト以外のナビゲーション以降のリダイレクト数を表す数値。
PerformanceNavigationTiming.type 読取専用: 文字列で、ナビゲーションの種類を表します。 "navigate"、"reload"、"back_forward" のいずれかです。
PerformanceNavigationTiming.unloadEventEnd 読取専用: DOMHighResTimeStamp で、ユーザーエージェントが前の文書の unload イベントを完了した直後の時間と等しい時間値を表します。
PerformanceNavigationTiming.unloadEventStart 読取専用: DOMHighResTimeStamp で、ユーザーエージェントが前の文書の unload イベントを開始する直前の時間と等しい時間値を表します。