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.

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

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

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

PerformanceEntry PerformanceResourceTiming PerformanceNavigationTiming

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

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

インスタンスプロパティ

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

PerformanceEntry.entryType 読取専用

"navigation" を返します。

PerformanceEntry.name 読取専用

文書の URL を返します。

PerformanceEntry.startTime 読取専用

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

PerformanceEntry.duration 読取専用

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

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

PerformanceResourceTiming.initiatorType 読取専用

"navigation" を返します。

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

PerformanceNavigationTiming.activationStart 読取専用 Experimental

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

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
PerformanceNavigationTiming
activationStart
Experimental
criticalCHRestart
Experimental
domComplete
domContentLoadedEventEnd
domContentLoadedEventStart
domInteractive
loadEventEnd
loadEventStart
notRestoredReasons
Experimental
redirectCount
toJSON
type
unloadEventEnd
unloadEventStart

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.

関連情報