PerformanceNavigationTiming

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

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

PerformanceEntry PerformanceResourceTiming PerformanceNavigationTiming

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

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

インスタンスプロパティ

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

PerformanceEntry.entryType 読取専用

"navigation" を返します。

PerformanceEntry.name 読取専用

文書の URL を返します。

PerformanceEntry.startTime 読取専用

値 "0" を持つ DOMHighResTimeStamp を返します。

PerformanceEntry.duration 読取専用

PerformanceNavigationTiming.loadEventEnd と PerformanceEntry.startTime の各プロパティの差である timestamp を返します。

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

PerformanceResourceTiming.initiatorType 読取専用

"navigation" を返します。

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

PerformanceNavigationTiming.activationStart (en-US) 読取専用

DOMHighResTimeStamp で、文書が事前レンダリングを始めてから有効になるまでの時間を表します。

PerformanceNavigationTiming.domComplete (en-US) 読取専用

DOMHighResTimeStamp で、ブラウザーが現在の文書の現在の文書レディネスを*完了*に設定する直前の時間と等しい時間値を表します。

PerformanceNavigationTiming.domContentLoadedEventEnd (en-US) 読取専用

DOMHighResTimeStamp で、現在の文書の DOMContentLoaded イベントが完了した直後の時間と等しい時間値を表します。

PerformanceNavigationTiming.domContentLoadedEventStart (en-US) 読取専用

DOMHighResTimeStamp で、現在の文書でユーザーエージェントが DOMContentLoaded イベントを起動する直前の時間と等しい時間値を表します。

PerformanceNavigationTiming.domInteractive (en-US) 読取専用

DOMHighResTimeStamp で、ユーザーエージェントがこの文書の readyState を "interactive" に設定する直前の時刻を表します。

PerformanceNavigationTiming.loadEventEnd 読取専用

DOMHighResTimeStamp で、現在の文書の load イベントが完了した時刻を表します。

PerformanceNavigationTiming.loadEventStart (en-US) 読取専用

DOMHighResTimeStamp で、現在の文書の load イベントが発生する直前の時間と等しい時間値を表します。

PerformanceNavigationTiming.redirectCount (en-US) 読取専用

現在の閲覧コンテキストでの最後のリダイレクト以外のナビゲーション以降のリダイレクト数を表す数値。

PerformanceNavigationTiming.type (en-US) 読取専用

文字列で、ナビゲーションの種類を表します。 "navigate"、"reload"、"back_forward"、"prerender" のいずれかです。

PerformanceNavigationTiming.unloadEventEnd (en-US) 読取専用

DOMHighResTimeStamp で、ユーザーエージェントが前の文書の unload イベントを完了した直後の時間と等しい時間値を表します。

PerformanceNavigationTiming.unloadEventStart (en-US) 読取専用

DOMHighResTimeStamp で、ユーザーエージェントが前の文書の unload イベントを開始する直前の時間と等しい時間値を表します。

インスタンスメソッド

PerformanceNavigationTiming.toJSON() (en-US)

PerformanceNavigationTiming オブジェクトの JSON 表現を返します。

仕様書

Specification
Navigation Timing Level 2
# sec-PerformanceNavigationTiming

ブラウザーの互換性

BCD tables only load in the browser

関連情報