PerformanceNavigationTiming
インターフェイスは、ブラウザのドキュメントナビゲーションイベントに関するメトリックを格納および取得するためのメソッドとプロパティを提供します。たとえば、このインターフェイスを使用して、ドキュメントのロードまたはアンロードにかかる時間を判断できます。
<div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 11.666666666666666%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 70" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/PerformanceEntry" target="_top"><rect x="1" y="1" width="160" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="81" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">PerformanceEntry</text></a><polyline points="161,25 171,20 171,30 161,25" stroke="#D4DDE4" fill="none"/><line x1="171" y1="25" x2="201" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/PerformanceNavigationTiming" target="_top"><rect x="201" y="1" width="270" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text x="336" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">PerformanceNavigationTiming</text></a></svg></div>
a:hover text { fill: #0095DD; pointer-events: all;}
プロパティ
このインターフェイスは、ナビゲーションパフォーマンスエントリタイプの以下の PerformanceEntry
プロパティを次のように限定して制限することで拡張します。
PerformanceEntry.entryType
読取専用"navigation"
を返します。PerformanceEntry.name
読取専用- ドキュメントのアドレス を返します。
PerformanceEntry.startTime
読取専用- 値 "
0
" を持つDOMHighResTimeStamp
を返します。 PerformanceEntry.duration
読取専用PerformanceNavigationTiming.loadEventEnd
とPerformanceEntry.startTime
の各プロパティの差であるtimestamp
を返します。
このインターフェイスは、ナビゲーションパフォーマンスエントリタイプの以下の PerformanceResourceTiming
プロパティも、次のように修飾して制約することで拡張します。
PerformanceResourceTiming.initiatorType
読取専用"navigation"
を返します。
インターフェイスは以下のプロパティもサポートします。
PerformanceNavigationTiming.domComplete
読取専用- ブラウザが現在のドキュメントの現在のドキュメントレディネスを完了に設定する直前の時間と等しい時間値を表す
DOMHighResTimeStamp
。 PerformanceNavigationTiming.domContentLoadedEventEnd
読取専用- 現在のドキュメントの DOMContentLoaded イベントが完了した直後の時間と等しい時間値を表す
DOMHighResTimeStamp
。 PerformanceNavigationTiming.domContentLoadedEventStart
読取専用- 現在のドキュメントでユーザーエージェントが DOMContentLoaded イベントを起動する直前の時間と等しい時間値を表す
DOMHighResTimeStamp
。 PerformanceNavigationTiming.domInteractive
読取専用- ユーザーエージェントが現在の文書の現在の文書の準備状態を interactive に設定する直前の時間に等しい時間値を表す
タイムスタンプ
を表すDOMHighResTimeStamp
。 PerformanceNavigationTiming.loadEventEnd
読取専用- 現在のドキュメントのロードイベントが完了した時刻を表す
DOMHighResTimeStamp
。 PerformanceNavigationTiming.loadEventStart
読取専用- 現在のドキュメントのロードイベントが発生する直前の時間と等しい時間値を表す
DOMHighResTimeStamp
。 PerformanceNavigationTiming.redirectCount
読取専用- 現在のブラウジングコンテキストでの最後のリダイレクト以外のナビゲーション以降のリダイレクト数を表す数値。
- リダイレクトがなかった場合、またはリダイレクトが別のオリジンからのもので、そのオリジンが現在のオリジンにタイミング情報を公開することを許可していない場合、値は 0 になります。
PerformanceNavigationTiming.responseStart
読取専用- ユーザーエージェントの HTTP パーサーが関連するアプリケーションキャッシュ、またはローカルリソースから、あるいはサーバからレスポンスの最初のバイトを受け取った直後の時間を表す
DOMHighResTimeStamp
。 PerformanceNavigationTiming.requestStart
読取専用- ユーザーエージェントがサーバ、または関連するアプリケーションキャッシュから、あるいはローカルリソースからリソースを要求し始める直前の時間を表す
DOMHighResTimeStamp
。
PerformanceNavigationTiming.type
読取専用- ナビゲーションタイプを表す
文字列
。"navigate
"、"reload
"、"back_forward
"、"prerender
"のいずれかです。 PerformanceNavigationTiming.unloadEventEnd
読取専用- ユーザーエージェントが前の文書のアンロードイベントを終了した直後の時間と等しい時間値を表す
DOMHighResTimeStamp
。 PerformanceNavigationTiming.unloadEventStart
読取専用- ユーザーエージェントが前のドキュメントのアンロードイベントを開始する直前の時間と等しい時間値を表す
DOMHighResTimeStamp
。
メソッド
PerformanceNavigationTiming.toJSON()
PerformanceNavigationTiming
オブジェクトの JSON 表現であるDOMString
を返します。
仕様
仕様書 | ステータス | コメント |
---|---|---|
Navigation Timing Level 2 PerformanceNavigationTiming の定義 |
草案 | 初期定義 |
ブラウザの互換性
このページの互換性テーブルは構造化データから生成されます。データに貢献したい場合は https://github.com/mdn/browser-compat-data をチェックして、プルリクエストを送ってください。