ナビゲーションタイミング レベル2

<html>
<head>
<script type="text/javascript">
var start = new Date().getTime();
function onLoad() {
  var now = new Date().getTime();
  var latency = now - start;
  alert("page loading time: " + latency);
}
</script>
</head>
<body onload="onLoad()">
<!- Main page body goes from here. -->
</body>
</html>

startTime:           0.000  // ナビゲーションリクエスト開始時刻
responseEnd:       100.000  // 最後に受信したバイトの高解像度時刻

<script>
function showNavigationDetails() {
  // 最初のエントリーを取得
  const [entry] = performance.getEntriesByType("navigation");
  // 開発者コンソールでテーブル表示
  console.table(entry.toJSON());
}
</script>
<body onload="showNavigationDetails()">

[Exposed=Window]
interface PerformanceNavigationTiming : PerformanceResourceTiming {
    readonly        attribute DOMHighResTimeStamp  unloadEventStart;
    readonly        attribute DOMHighResTimeStamp  unloadEventEnd;
    readonly        attribute DOMHighResTimeStamp  domInteractive;
    readonly        attribute DOMHighResTimeStamp  domContentLoadedEventStart;
    readonly        attribute DOMHighResTimeStamp  domContentLoadedEventEnd;
    readonly        attribute DOMHighResTimeStamp  domComplete;
    readonly        attribute DOMHighResTimeStamp  loadEventStart;
    readonly        attribute DOMHighResTimeStamp  loadEventEnd;
    readonly        attribute NavigationTimingType type;
    readonly        attribute unsigned short       redirectCount;
    readonly        attribute DOMHighResTimeStamp  criticalCHRestart;
    readonly        attribute NotRestoredReasons?  notRestoredReasons;
    readonly        attribute PerformanceTimingConfidence confidence;
    [Default] object toJSON();
};

enum NavigationTimingType {
    "navigate",
    "reload",
    "back_forward"
};

[Exposed=Window]
interface PerformanceTimingConfidence {
    readonly attribute double randomizedTriggerRate;
    readonly attribute PerformanceTimingConfidenceValue value;
    object toJSON();
};

enum PerformanceTimingConfidenceValue {
  "high",
  "low"
};

8. 廃止

このセクションでは、[NAVIGATION-TIMING] Level 1 で導入され、後方互換性のために残された属性やインターフェースについて定義します。 著者は下記インターフェースの使用を避け、 必ず 新しいPerformanceNavigationTiming インターフェースを利用してください——変更と改善の一覧を参照。

8.1. PerformanceTiming インターフェース

[Exposed=Window]
interface PerformanceTiming {
  readonly attribute unsigned long long navigationStart;
  readonly attribute unsigned long long unloadEventStart;
  readonly attribute unsigned long long unloadEventEnd;
  readonly attribute unsigned long long redirectStart;
  readonly attribute unsigned long long redirectEnd;
  readonly attribute unsigned long long fetchStart;
  readonly attribute unsigned long long domainLookupStart;
  readonly attribute unsigned long long domainLookupEnd;
  readonly attribute unsigned long long connectStart;
  readonly attribute unsigned long long connectEnd;
  readonly attribute unsigned long long secureConnectionStart;
  readonly attribute unsigned long long requestStart;
  readonly attribute unsigned long long responseStart;
  readonly attribute unsigned long long responseEnd;
  readonly attribute unsigned long long domLoading;
  readonly attribute unsigned long long domInteractive;
  readonly attribute unsigned long long domContentLoadedEventStart;
  readonly attribute unsigned long long domContentLoadedEventEnd;
  readonly attribute unsigned long long domComplete;
  readonly attribute unsigned long long loadEventStart;
  readonly attribute unsigned long long loadEventEnd;
  [Default] object toJSON();
};

このセクションで定義されるすべての時刻値は、1970年1月1日（UTC）の午前0時からのミリ秒数で測定されます。

navigationStart

この属性は、ユーザーエージェントが前の文書を アンロードするよう求める処理を 完了した直後の時刻を返さなければならない。前の 文書がない場合、この属性は現在の 文書が作成された時刻を返さなければならない。

この属性は PerformanceNavigationTiming には定義されていない。代わりに、作者は timeOrigin を使用して同等のタイムスタンプを取得できる。

unloadEventStart

前の文書と現在の文書が同じ オリジンを持つ場合、この 属性は ユーザーエージェントが前の文書の unload イベントを 開始する直前の時刻を返さなければならない。前の文書がない場合、または 前の文書が現在の文書とは異なるオリジンを 持つ場合、この 属性はゼロを返さなければならない。

unloadEventEnd

前の文書と現在の文書が同じ 同一オリジンである場合、この 属性は ユーザーエージェントが前の文書の unload イベントを 完了した直後の時刻を返さなければならない。前の文書がない場合、または 前の文書が現在の文書とは異なるオリジンを 持つ場合、あるいは unload がまだ完了していない場合、この属性はゼロを返さなければならない。

ナビゲーション時にHTTP リダイレクトがあり、すべてのリダイレクトが 同じオリジンからのものでない場合、 unloadEventStart と unloadEventEnd はどちらもゼロを返さなければならない。

redirectStart

ナビゲーション時にHTTP リダイレクトがあり、かつすべてのリダイレクトが 同じオリジンからのものである場合、この 属性はリダイレクトを開始するフェッチの開始時刻を 返さなければならない。それ以外の場合、この属性は ゼロを返さなければならない。

redirectEnd

ナビゲーション時にHTTP リダイレクトがあり、すべてのリダイレクトが同じ オリジンからのものである場合、この 属性は 最後のリダイレクトのレスポンスの最後のバイトを受信した 直後の時刻を返さなければならない。それ以外の場合、この属性は ゼロを返さなければならない。

fetchStart

新しいリソースが "GET" でフェッチされる リクエスト メソッドを使用する場合、fetchStart は ユーザーエージェントが HTTP キャッシュ [RFC9111]の確認を開始する直前の時刻を 返さなければならない。それ以外の場合、これは ユーザーエージェントがリソースのフェッチを 開始する時刻を返さなければならない。

domainLookupStart

この属性は ユーザーエージェントが現在の文書のドメイン名検索を開始する直前の時刻を 返さなければならない。 持続的 接続 [RFC9112]が使用される場合、または 現在の文書が HTTP キャッシュ [RFC9111]もしくはローカルリソースから取得される場合、 この属性は fetchStartと同じ値を返さなければならない。

domainLookupEnd

この属性は、 ユーザーエージェントが現在の文書のドメイン名検索を完了した直後の時刻を返さなければならない。 持続的 接続 [RFC9112]が使用される場合、または 現在の文書が HTTP キャッシュ [RFC9111]もしくはローカルリソースから取得される場合、 この属性は fetchStartと同じ値を返さなければならない。

HTTP キャッシュ [RFC9111]からの 内容の確認および取得は フェッチ処理の一部である。これは requestStart、 responseStart および responseEnd 属性によって扱われる。

ユーザーエージェントがすでにドメイン情報を キャッシュ内に持っている場合、domainLookupStart と domainLookupEnd は、 ユーザーエージェントがキャッシュからのドメインデータの 取得を開始および終了する時刻を表す。

connectStart

この属性は、 ユーザーエージェントが文書を取得するためにサーバーへの接続の確立を 開始する直前の時刻を返さなければならない。持続的 接続 [RFC9112]が使用される場合、または現在の文書が HTTP キャッシュ [RFC9111]もしくは ローカルリソースから取得される場合、この属性は domainLookupEndの値を返さなければならない。

connectEnd

この属性は、 ユーザーエージェントが現在の文書を取得するためのサーバーへの接続の 確立を完了した直後の時刻を返さなければならない。 持続的接続 [RFC9112]が使用される場合、または 現在の文書が HTTP キャッシュ [RFC9111]もしくはローカルリソースから取得される場合、 この属性は domainLookupEndの値を返さなければならない。

トランスポート接続が失敗し、ユーザーエージェントが 接続を再度開いた場合、connectStart と connectEnd は新しい接続の対応する 値を返すべきである。

connectEnd はトランスポート接続を確立するための時間間隔に加えて、 SSL ハンドシェイクや SOCKS 認証などのその他の時間 間隔も含まなければならない。

secureConnectionStart

この属性は任意である。この 属性を利用できないユーザーエージェントは、これを undefined に設定しなければならない。この属性が 利用可能な場合、現在のページのスキーム [URL]が "https" であれば、この属性は ユーザーエージェントが現在の接続をセキュアにするためのハンドシェイク処理を 開始する直前の時刻を返さなければならない。この属性が利用可能であっても HTTPS が 使用されていない場合、この属性はゼロを返さなければならない。

requestStart

この属性は、 ユーザーエージェントがサーバー、または HTTP キャッシュ [RFC9111]もしくはローカル リソースから現在の文書を要求し始める直前の時刻を返さなければならない。

リクエストが送信された後にトランスポート接続が失敗し、 ユーザーエージェントが接続を再度開いてリクエストを再送信する場合、 requestStart は新しいリクエストの 対応する値を返すべきである。

このインターフェイスには、 リクエスト送信の完了を表す属性、たとえば requestEnd は含まれていない。

• ユーザーエージェントからのリクエスト送信の完了は、 ネットワークトランスポートにおける対応する完了時刻を必ずしも示すとは 限らず、そのため、そのような属性を持つことによる利点の 大部分が失われる。
• 一部のユーザーエージェントでは、HTTP レイヤーの カプセル化により、リクエスト送信の実際の 完了時刻を判断するコストが高い。

responseStart

この属性は、 ユーザーエージェントがサーバー、または HTTP キャッシュ [RFC9111]もしくはローカル リソースからレスポンスの最初のバイトを受信した直後の時刻を返さなければならない。

responseEnd

この属性は、 ユーザーエージェントが現在の文書の最後のバイトを受信した直後、または トランスポート接続が閉じられる直前のいずれか 早い方の時刻を返さなければならない。ここでの文書は、 サーバー、HTTP キャッシュ [RFC9111]、または ローカルリソースのいずれから受信されてもよい。

domLoading

この属性は、 ユーザーエージェントが現在の文書の 準備状態を"loading"に設定する直前の時刻を返さなければならない。

既存のユーザーエージェント間で Document オブジェクトが作成される タイミングが異なるため、 domLoading が返す値は実装固有であり、 意味のある指標には使用すべきではない。

domInteractive

この属性は、 ユーザーエージェントが現在の文書の 準備状態を"interactive"に設定する直前の時刻を返さなければならない。

domContentLoadedEventStart

この属性は、 ユーザーエージェントがDocumentで DOMContentLoaded イベントを発火する直前の時刻を返さなければならない。

domContentLoadedEventEnd

この属性は、 文書のDOMContentLoaded イベントが完了した直後の時刻を返さなければならない。

domComplete

この属性は、 ユーザーエージェントが現在の文書の 準備状態を"complete"に設定する直前の時刻を返さなければならない。

現在の文書の 準備状態が同じ状態に複数回変化する場合、 domLoading、 domInteractive、 domContentLoadedEventStart、 domContentLoadedEventEnd および domComplete は、対応する文書の準備状態の 変更が最初に発生した時刻を返さなければならない。

loadEventStart

この属性は、現在の文書の load イベントが発火する直前の時刻を返さなければならない。 load イベントがまだ発火していない場合はゼロを返さなければならない。

loadEventEnd

この属性は、現在の文書の load イベントが 完了した時刻を返さなければならない。load イベントが発火していないか、完了していない場合はゼロを返さなければならない。

toJSON()

this に対してデフォルトの toJSON 手順を実行する。

8.2. PerformanceNavigation インターフェース

[Exposed=Window]
interface PerformanceNavigation {
  const unsigned short TYPE_NAVIGATE = 0;
  const unsigned short TYPE_RELOAD = 1;
  const unsigned short TYPE_BACK_FORWARD = 2;
  const unsigned short TYPE_RESERVED = 255;
  readonly attribute unsigned short type;
  readonly attribute unsigned short redirectCount;
  [Default] object toJSON();
};

TYPE_NAVIGATE

履歴処理動作が "default" または "replace" に 設定されているナビゲーション。

TYPE_RELOAD

履歴処理動作が "reload" に 設定されているナビゲーション。

TYPE_BACK_FORWARD

履歴処理動作が "entry update" に 設定されているナビゲーション。

TYPE_RESERVED

上記の値で定義されていないすべてのナビゲーション種別。

type

この属性は、最後の非リダイレクト ナビゲーションの種別を返さなければならない。 これは、次のナビゲーション種別 値のいずれかでなければならない。

Refresh pragma ディレクティブを使用するものなどのクライアント側リダイレクトは、この仕様ではHTTP リダイレクトとは見なされない。そのような 場合、type 属性は、現在のページを再読み込みする場合は TYPE_RELOAD、新しい URL にナビゲートする場合は TYPE_NAVIGATE など、適切な値を返すべきである。

redirectCount

この属性は、最後の 非リダイレクトナビゲーション以降のリダイレクト数を返さなければならない。リダイレクトがない場合、または 宛先文書と 同一オリジンではない リダイレクトが 1 つでもある場合、この属性はゼロを返さなければならない。

toJSON()

this に対してデフォルトの toJSON 手順を実行する。

8.3. Performance インターフェースへの拡張

[Exposed=Window]
partial interface Performance {
  [SameObject]
  readonly attribute PerformanceTiming timing;
  [SameObject]
  readonly attribute PerformanceNavigation navigation;
};

Performance インターフェースは [PERFORMANCE-TIMELINE-2] で定義されています。

timing

timing属性は、最後の非リダイレクトナビゲーションからのタイミング情報を表します。 この属性はPerformanceTimingインターフェースで定義されています。

navigation

navigation属性はPerformanceNavigationインターフェースで定義されています。