リソースタイミング

このセクションは規範的ではありません。

非nullのclientによって Requestが フェッチされると、 PerformanceResourceTiming オブジェクトとして グローバルオブジェクトの Performance Timelineに含まれます。 ただし、フェッチ処理の一部として タイムラインから除外される場合は含まれません。HTTPキャッシュから取得されたリソースも PerformanceResourceTiming オブジェクトとして Performance Timelineに含まれます。 フェッチが開始されたが後に中断された（例：ネットワークエラー等）リソースも、 開始・終了タイミングとともに PerformanceResourceTiming オブジェクトとして Performance Timelineに含まれます。

例：

• 同じ正規URLが2つのHTML IMG要素のsrc属性として使用された場合、最初のHTML IMG要素によって開始された フェッチは PerformanceResourceTiming オブジェクトとして Performance Timelineに含まれます。 ユーザーエージェントは2つ目のHTML IMG要素用にURLを再度リクエストせず、最初のHTML IMG要素のために開始された 既存のダウンロードを利用する場合があります。この場合、最初のIMG要素による フェッチのみが Performance Timelineに記録されます。
• HTML IMG要素のsrc属性がスクリプトにより変更された場合、元のリソースの フェッチと、 新しいURLのフェッチの両方が PerformanceResourceTiming オブジェクトとして Performance Timelineに含まれます。
• HTML IFRAME要素がマークアップで追加され、src属性が指定されていない場合、 ユーザーエージェントはabout:blankドキュメントをロードする場合があります。 後でsrc属性がスクリプトで動的に変更された場合、ユーザーエージェントは新しいURLリソースを フェッチする場合があります。 この場合、新しいURLの フェッチのみが PerformanceResourceTiming オブジェクトとして Performance Timelineに含まれます。
• 同じ正規URLに対してXMLHttpRequestが2回生成された場合、両方の フェッチは PerformanceResourceTiming オブジェクトとして Performance Timelineに含まれます。 これは、2回目のXMLHttpRequestのリソースフェッチが最初のXMLHttpRequestで発行されたダウンロードを 再利用できないためです。
• HTML IFRAME要素がページに含まれている場合、 IFRAMEのsrc属性によってリクエストされたリソースのみが PerformanceResourceTiming オブジェクトとして Performance Timelineに含まれます。 IFRAMEドキュメントでリクエストされるサブリソースは IFRAMEドキュメントの Performance Timelineに含まれ、 親ドキュメントのPerformance Timelineには含まれません。
• HTML IMG要素が data: URIをソースとして持つ場合 [RFC2397]、 このリソースは PerformanceResourceTiming オブジェクトとして Performance Timelineに含まれません。 PerformanceResourceTiming エントリは http(s)リソースのみが報告されます。
• リソースのフェッチが ネットワークエラー（例：DNS、TCP、TLSエラー）により中断された場合、 フェッチは PerformanceResourceTiming オブジェクトとして Performance Timelineに含まれ、 startTime、fetchStart、duration、responseEndのみが設定されます。
• リソースのフェッチが フェッチプリコンディション（例：混在コンテンツ、CORS制限、CSPポリシーなど）に失敗して中断された場合、 このリソースは PerformanceResourceTiming オブジェクトとして Performance Timelineに含まれません。

WebIDL[Exposed=(Window,Worker)]
interface PerformanceResourceTiming : PerformanceEntry {
    readonly attribute DOMString initiatorType;
    readonly attribute DOMString deliveryType;
    readonly attribute ByteString nextHopProtocol;
    readonly attribute DOMHighResTimeStamp workerStart;
    readonly attribute DOMHighResTimeStamp redirectStart;
    readonly attribute DOMHighResTimeStamp redirectEnd;
    readonly attribute DOMHighResTimeStamp fetchStart;
    readonly attribute DOMHighResTimeStamp domainLookupStart;
    readonly attribute DOMHighResTimeStamp domainLookupEnd;
    readonly attribute DOMHighResTimeStamp connectStart;
    readonly attribute DOMHighResTimeStamp connectEnd;
    readonly attribute DOMHighResTimeStamp secureConnectionStart;
    readonly attribute DOMHighResTimeStamp requestStart;
    readonly attribute DOMHighResTimeStamp finalResponseHeadersStart;
    readonly attribute DOMHighResTimeStamp firstInterimResponseStart;
    readonly attribute DOMHighResTimeStamp responseStart;
    readonly attribute DOMHighResTimeStamp responseEnd;
    readonly attribute DOMHighResTimeStamp workerRouterEvaluationStart;
    readonly attribute DOMHighResTimeStamp workerCacheLookupStart;
    readonly attribute DOMString workerMatchedRouterSource;
    readonly attribute DOMString workerFinalRouterSource;
    readonly attribute unsigned long long  transferSize;
    readonly attribute unsigned long long  encodedBodySize;
    readonly attribute unsigned long long  decodedBodySize;
    readonly attribute unsigned short responseStatus;
    readonly attribute RenderBlockingStatusType renderBlockingStatus;
    readonly attribute DOMString contentType;
    readonly attribute DOMString contentEncoding;
    [Default] object toJSON();
};

PerformanceResourceTiming には関連付けられた DOMString の initiator type がある。

PerformanceResourceTiming には関連付けられた DOMString の delivery type がある。

PerformanceResourceTiming には関連付けられた DOMString の requested URL がある。

PerformanceResourceTiming には関連付けられた DOMString の cache mode （空の文字列、"local"、または "validated"）。

PerformanceResourceTiming には fetch timing info の timing info が関連付けられています。

PerformanceResourceTiming には response body info の resource info が関連付けられています。

PerformanceResourceTiming には status の response status が関連付けられています。

PerformanceResourceTiming には RenderBlockingStatusType の render-blocking status が関連付けられています。

toJSON が呼び出されたときは、 default toJSON steps を PerformanceResourceTiming に対して実行します。

initiatorType のgetter手順は、initiator type を this に対して返します。

deliveryType のgetter手順は、 delivery type を this に対して返します。

workerStart のgetter手順は、fetchタイムスタンプの変換を this の timing info の final service worker start time および relevant global object に対して実行します。詳細は HTTP fetch を参照してください。

redirectStart のgetter手順は、fetchタイムスタンプの変換を this の timing info の redirect start time および relevant global object に対して実行します。詳細は HTTP-redirect fetch を参照してください。

redirectEnd のgetter手順は、fetchタイムスタンプの変換を this の timing info の redirect end time および relevant global object に対して実行します。詳細は HTTP-redirect fetch を参照してください。

fetchStart のgetter手順は、fetchタイムスタンプの変換を this の timing info の post-redirect start time および relevant global object に対して実行します。詳細は HTTP fetch を参照してください。

domainLookupStart のgetter手順は、fetchタイムスタンプの変換を this の timing info の final connection timing info の domain lookup start time および relevant global object に対して実行します。詳細は 接続タイミング情報の記録 を参照してください。

domainLookupEnd のgetter手順は、fetchタイムスタンプの変換を this の timing info の final connection timing info の domain lookup end time および relevant global object に対して実行します。詳細は 接続タイミング情報の記録 を参照してください。

connectStart のgetter手順は、fetchタイムスタンプの変換を this の timing info の final connection timing info の connection start time および relevant global object に対して実行します。詳細は 接続タイミング情報の記録 を参照してください。

connectEnd のgetter手順は、fetchタイムスタンプの変換を this の timing info の final connection timing info の connection end time および relevant global object に対して実行します。詳細は 接続タイミング情報の記録 を参照してください。

secureConnectionStart のgetter手順は、fetchタイムスタンプの変換を this の timing info の final connection timing info の secure connection start time および relevant global object に対して実行します。詳細は 接続タイミング情報の記録 を参照してください。

nextHopProtocol のgetter手順は、 isomorphic decode を this の timing info の final connection timing info の ALPN negotiated protocol に対して実行します。詳細は 接続タイミング情報の記録 を参照してください。

requestStart のgetter手順は、fetchタイムスタンプの変換を this の timing info の final network-request start time および relevant global object に対して実行します。詳細は HTTP fetch を参照してください。

firstInterimResponseStart のgetter手順は、 fetchタイムスタンプの変換を this の timing info の first interim network-response start time および relevant global object に対して実行します。詳細は HTTP fetch を参照してください。

finalResponseHeadersStart のgetter手順は、 fetchタイムスタンプの変換を this の timing info の final network-response start time および relevant global object に対して実行します。詳細は HTTP fetch を参照してください。

responseStart のgetter手順は、 this の firstInterimResponseStart が 0 でない場合はそれを返し、そうでなければ this の finalResponseHeadersStart を返します。

responseEnd のgetter手順は、fetchタイムスタンプの変換を this の timing info の end time および relevant global object に対して実行します。詳細は fetch を参照してください。

encodedBodySize のgetter手順は、 this の resource info の encoded size を返します。

decodedBodySize のgetter手順は、 this の resource info の decoded size を返します。

transferSize のgetter手順は以下の通りです：

1. this の cache mode が "local" の場合は 0 を返す。

2. this の cache mode が "validated" の場合は 300 を返す。

3. this の response body info の encoded size に 300 を加えて返す。

   注

   transferSizeに加算される定数値は、HTTPヘッダーの総バイト数を公開するかわりです。これは特定のクッキーの存在を暴露する可能性があるためです。詳細は このissue を参照してください。

responseStatus のgetter手順は、 this の response status を返します。

contentType のgetter手順は、 this の resource info の content type を返します。

contentEncoding のgetter手順は、 this の resource info の content encoding を返します。

renderBlockingStatus のgetter手順は、 blocking を返します。 ただし this の timing info の render-blocking が true の場合のみで、 それ以外は non-blocking を返します。

workerRouterEvaluationStart の getter 手順は、次を返すことである： this の timing info の service worker timing info の worker router evaluation start。

workerCacheLookupStart の getter 手順は、次を返すことである： this の timing info の service worker timing info の worker cache lookup start。

workerMatchedRouterSource の getter 手順は、次を返すことである： this の timing info の service worker timing info の worker matched router source。

workerFinalRouterSource の getter 手順は、 return this の timing info の service worker timing info の worker final router source を返すことである。

WebIDLenum RenderBlockingStatusType {
    "blocking",
    "non-blocking"
};

ユーザーエージェントは、PerformanceResourceTiming オブジェクトとして Performance Timeline [PERFORMANCE-TIMELINE-2] に含まれるリソース数を 制限することが できます。 本セクションは、Performance インターフェイスに、PerformanceResourceTiming オブジェクトの保存数を制御する機能を追加します。

推奨される PerformanceResourceTiming オブジェクトの最小数は 250 ですが、これはユーザーエージェントによって変更可能です。 この制限の変更は setResourceTimingBufferSize を呼び出して要求できます。

各 ECMAScript グローバル環境は次を持ちます：

• リソースタイミングバッファサイズ制限（初期値は250以上が望ましい）
• リソースタイミングバッファ現在サイズ（初期値は0）
• リソースタイミングバッファフルイベント保留フラグ（初期値はfalse）
• リソースタイミングセカンダリバッファ現在サイズ（初期値は0）
• リソースタイミングセカンダリバッファ（PerformanceResourceTiming オブジェクトを格納、初期値は空）

WebIDLpartial interface Performance {
          undefined clearResourceTimings ();
          undefined setResourceTimingBufferSize (unsigned long maxSize);
          attribute EventHandler onresourcetimingbufferfull;
        };

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

clearResourceTimings メソッドは次の手順を実行します：

1. PerformanceResourceTiming オブジェクトを performance entry buffer からすべて削除します。
2. リソースタイミングバッファ現在サイズ を0に設定します。

setResourceTimingBufferSize メソッドは次の手順を実行します：

1. リソースタイミングバッファサイズ制限 を maxSize パラメータに設定します。 maxSize パラメータが リソースタイミングバッファ現在サイズ より小さい場合、 PerformanceResourceTiming オブジェクトは performance entry buffer から削除しません。

onresourcetimingbufferfull 属性は、 以下で説明する resourcetimingbufferfull イベントのイベントハンドラーです。

リソースタイミングエントリ追加可能か を判定するには、次の手順を実行します：

1. リソースタイミングバッファ現在サイズ が リソースタイミングバッファサイズ制限 より小さい場合、trueを返す。
2. falseを返す。

PerformanceResourceTimingエントリ追加（new entry）を performance entry buffer に追加するには、次の手順を実行します：

1. リソースタイミングエントリ追加可能か がtrueで リソースタイミングバッファフルイベント保留フラグ がfalseの場合、以下を実行：
   1. new entry を performance entry buffer に追加
   2. リソースタイミングバッファ現在サイズ を1増やす
   3. 終了
2. リソースタイミングバッファフルイベント保留フラグ が falseの場合、以下を実行：
   1. リソースタイミングバッファフルイベント保留フラグ を trueに設定
   2. タスクをキューに追加 （ performance timeline task source）して バッファフルイベント発火 を実行
3. new entry を リソースタイミングセカンダリバッファ に追加
4. リソースタイミングセカンダリバッファ現在サイズ を1増やす

セカンダリバッファのコピー は次の手順で実行します：

1. リソースタイミングセカンダリバッファ が空でなく リソースタイミングエントリ追加可能か がtrueの場合、以下を繰り返す：
   1. entry を PerformanceResourceTiming のうち最も古いものとして リソースタイミングセカンダリバッファから取得
   2. entry を performance entry buffer の末尾に追加
   3. リソースタイミングバッファ現在サイズ を1増やす
   4. entry を リソースタイミングセカンダリバッファ から削除
   5. リソースタイミングセカンダリバッファ現在サイズ を1減らす

バッファフルイベント発火 は次の手順で実行します：

1. リソースタイミングセカンダリバッファ が空でない限り、以下を繰り返す：
   1. number of excess entries before を リソースタイミングセカンダリバッファ現在サイズ とする
   2. リソースタイミングエントリ追加可能か がfalseの場合、 イベントを発火（名前：resourcetimingbufferfull）、 Performance オブジェクトに対して
   3. セカンダリバッファのコピー を実行
   4. number of excess entries after を リソースタイミングセカンダリバッファ現在サイズ とする
   5. number of excess entries before が number of excess entries after 以下の場合、 リソースタイミングセカンダリバッファ をすべて削除し、 リソースタイミングセカンダリバッファ現在サイズ を0に設定し、 この手順を中止
2. リソースタイミングバッファフルイベント保留フラグ を falseに設定
   注

   これは resourcetimingbufferfull イベントハンドラーが バッファに追加するリソースより多くのバッファ領域を追加しない場合、 余分なエントリがバッファから破棄されることを意味します。 開発者は resourcetimingbufferfull イベントハンドラーで clearResourceTimings を呼び出すか、十分にバッファ拡張 （setResourceTimingBufferSize の呼び出し）するようにしてください。

サーバー側アプリケーションは、ユーザーエージェントが、指定された文書オリジンに対して、 これらのクロスオリジン制限により 0 となっていた属性値を完全に公開できるようにするため、 Timing-Allow-Origin HTTP レスポンス・ヘッダーを返してよい。

Timing-Allow-Origin HTTP レスポンス・ヘッダー・フィールドは、 クロスオリジン制限により 0 となっていた属性値を参照することが許可される オリジンを示すポリシーを伝達するために使用できる。 ヘッダーの値は、次の ABNF [RFC5234]（List Extension を使用、[RFC9110]）で表される：

送信者は Timing-Allow-Origin ヘッダー・フィールドを複数生成してもよい。 受信者は、複数の Timing-Allow-Origin ヘッダー・フィールドを、 後続の各フィールド値を順に結合フィールド値へ付加し、コンマで区切ることで、結合してもよい。

ユーザーエージェントは、Timing-Allow-Origin HTTP レスポンス・ヘッダー・フィールドがあっても、 なおクロスオリジン制限を強制し、transferSize、encodedBodySize、decodedBodySize 属性を 0 に設定してもよい。そうする場合、deliveryType を "" に設定してもよい。

Timing-Allow-Origin ヘッダーは、 属性を適切に計算するために FETCH で処理される。

この節は Timing-Allow-Origin を 暫定メッセージ・ヘッダー として登録する。

ヘッダー・フィールド名：

Timing-Allow-Origin

適用可能なプロトコル：

http

ステータス：

provisional

著者／変更管理者：

W3C

仕様書文書：

4.6 Timing-Allow-Origin レスポンス・ヘッダー