リソースタイミング

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

非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 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 を返します。

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 の呼び出し）するようにしてください。

サーバーサイドアプリケーションは、Timing-Allow-Origin HTTPレスポンスヘッダーを返すことで、ドキュメントのオリジン（指定されたもの）に対し、クロスオリジン制限でゼロになった属性値を完全に公開することができます。

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

以下のグラフは、PerformanceResourceTimingインターフェイスで定義されるタイミング属性を示します。 括弧内の属性は、クロスオリジンリソースのフェッチ時に利用できない場合があります。 ユーザーエージェントはタイミング間で内部処理を行うことがあり、タイミング間に非規範的な間隔が発生する場合があります。

mark resource timing を行うには、fetch timing info timingInfo、 DOMString requestedURL、 DOMString initiatorType、 global object global、 string cacheMode、 response body info bodyInfo、 status responseStatus、 およびオプションの string deliveryType （デフォルトは空文字列）を与え、以下の手順を実行します：

1. PerformanceResourceTiming オブジェクト entry を global の realm に作成します。
2. リソースタイミングエントリのセットアップ を entry に対して、initiatorType、requestedURL、timingInfo、cacheMode、bodyInfo、responseStatus、deliveryType を与えて実行します。
3. キューに追加 entry を行います。
4. 追加 entry を global の performance entry buffer に追加します。

リソースタイミングエントリのセットアップ を PerformanceResourceTiming entry に対して、 DOMString initiatorType、DOMString requestedURL、fetch timing info timingInfo、DOMString cacheMode、response body info bodyInfo、status responseStatus、およびオプションのDOMString deliveryType（デフォルトは空文字列）を与え、以下の手順を実行します：

1. cacheMode が空文字列、"local"、または "validated" であることを確認します。
2. global を entry の relevant global object とします。
3. PerformanceEntryの初期化 を entry に対して行います。引数は global を与えて fetchタイムスタンプの変換で得た timingInfo の start time、 "resource"、requestedURL、 および fetchタイムスタンプの変換で得た timingInfo の end time を与えます。
4. entry の initiator type を initiatorType に設定します。
5. entry の requested URL を requestedURL に設定します。
6. entry の timing info を timingInfo に設定します。
7. entry の response body info を bodyInfo に設定します。
8. entry の cache mode を cacheMode に設定します。
9. entry の response status を responseStatus に設定します。
10. deliveryType が空文字列で cacheMode が空でない場合、 deliveryType を "cache" に設定します。
11. entry の delivery type を deliveryType に設定します。

fetchタイムスタンプの変換は、 DOMHighResTimeStamp ts と global object global を与えて、以下を実行します：

1. ts がゼロの場合はゼロを返します。
2. それ以外の場合は、相対高精度コース時間 を ts と global に与えて返します。