PerformanceNavigationTiming

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2021.

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 読取専用

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

PerformanceNavigationTiming.domComplete 読取専用

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

PerformanceNavigationTiming.domContentLoadedEventEnd 読取専用

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

PerformanceNavigationTiming.domContentLoadedEventStart 読取専用

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

PerformanceNavigationTiming.domInteractive 読取専用

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

PerformanceNavigationTiming.loadEventEnd 読取専用

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

PerformanceNavigationTiming.loadEventStart 読取専用

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

PerformanceNavigationTiming.redirectCount 読取専用

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

PerformanceNavigationTiming.type 読取専用

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

PerformanceNavigationTiming.unloadEventEnd 読取専用

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

PerformanceNavigationTiming.unloadEventStart 読取専用

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

インスタンスメソッド

PerformanceNavigationTiming.toJSON()

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

仕様書

Specification
Navigation Timing Level 2
# sec-PerformanceNavigationTiming

ブラウザーの互換性

BCD tables only load in the browser

関連情報