リソースタイミング

3.2. Resources Included in the PerformanceResourceTiming Interface

この節は非規範的です。

非 null の クライアント によって Request が fetch されると、 それらはクライアントのグローバルオブジェクトの Performance Timeline に PerformanceResourceTiming オブジェクトとして含まれます（fetch 過程でタイムラインから除外されない限り）。HTTP キャッシュから取り出されたリソースも PerformanceResourceTiming オブジェクトとして Performance Timeline に含まれます。fetch が開始されたが後に中止されたリソース（ネットワークエラー等）は、 開始および終了のタイミング情報を持つ PerformanceResourceTiming オブジェクトとして Performance Timeline に含まれます。

例:

• 同一の正規化された URL が2つの HTML IMG 要素の src 属性として使われている場合、 最初に発起された fetch が Performance Timeline に含まれます。ユーザーエージェントは2つ目の IMG のために再リクエストを行わず、 最初の IMG に対する既存のダウンロードを利用するかもしれません。この場合、最初の IMG による fetch のみが Performance Timeline に現れます。
• スクリプトにより HTML IMG 要素の src 属性が変更された場合、元のリソースの fetch と新しい URL の fetch の両方が Performance Timeline に PerformanceResourceTiming オブジェクトとして含まれます。
• マークアップで IFRAME 要素が追加され src 属性が指定されていない場合、ユーザーエージェントはその IFRAME に対して about:blank 文書を読み込むことがあります。 後にスクリプトで src 属性が動的に変更されると、ユーザーエージェントは IFRAME のために新しい URL のリソースを fetch することがあります。このケースでは、新しい URL の fetch のみが親の Performance Timeline ではなく IFRAME の Performance Timeline に PerformanceResourceTiming オブジェクトとして含まれます。
• 同じ正規化 URL に対して XMLHTTPRequest が二回発行された場合、両方の fetch が Performance Timeline に含まれます。 これは 2 回目の XMLHTTPRequest のための fetch が最初の XMLHTTPRequest のダウンロードを再利用できないためです。
• ページに HTML IFRAME 要素が含まれる場合、そのページに含まれるのは IFRAME の src 属性で要求されたリソースのみであり、 サブリソースは IFRAME 文書自身の Performance Timeline に含まれ、親文書の Performance Timeline には含まれません。
• HTML IMG 要素のソースが data: URI の場合、そのリソースは Performance Timeline に含まれません。PerformanceResourceTiming エントリは http(s) リソースに対してのみ報告されます。
• fetch がネットワークエラー（DNS, TCP, TLS 等）により中止された場合、その fetch は startTime、fetchStart、duration、responseEnd のみが設定された PerformanceResourceTiming オブジェクトとして Performance Timeline に含まれます。
• fetch が事前条件（混合コンテンツ、CORS 制限、CSP ポリシー等）により中止された場合、そのリソースは Performance Timeline に PerformanceResourceTiming オブジェクトとして含まれません。

3.3. The PerformanceResourceTiming Interface

[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 が呼ばれたときは、デフォルトの toJSON 手順 を PerformanceResourceTiming に対して実行します。

initiatorType の getter 手順は、 initiator type をこのオブジェクトに対して返します。

initiatorType の設定は、リソースタイミングエントリが報告される各所（例えば Fetch 標準）で行われます。

deliveryType の getter 手順は、このオブジェクトの delivery type を返します。

workerStart のゲッター手順は、 取得タイムスタンプの変換を this の timing info の final service worker start time および relevant global object を this に対して実行することである。 詳細は HTTP fetch を参照のこと。

redirectStart のゲッター手順は、 取得タイムスタンプの変換を this の timing info の redirect start time および relevant global object を this に対して実行することである。詳細は HTTP-redirect fetch を参照のこと。

redirectEnd のゲッター手順は、 取得タイムスタンプの変換を this の timing info の redirect end time および relevant global object を this に対して実行することである。詳細は HTTP-redirect fetch を参照のこと。

fetchStart のゲッター手順は、 取得タイムスタンプの変換を this の timing info の post-redirect start time および relevant global object を this に対して実行することである。詳細は HTTP fetch を参照のこと。

domainLookupStart のゲッター手順は、 取得タイムスタンプの変換を this の timing info の final connection timing info の domain lookup start time および relevant global object を this に対して実行することである。 詳細は 接続タイミング情報の記録 を参照のこと。

domainLookupEnd のゲッター手順は、 取得タイムスタンプの変換を this の timing info の final connection timing info の domain lookup end time および relevant global object を this に対して実行することである。 詳細は 接続タイミング情報の記録 を参照のこと。

connectStart のゲッター手順は、 取得タイムスタンプの変換を this の timing info の final connection timing info の connection start time および relevant global object を this に対して実行することである。 詳細は 接続タイミング情報の記録 を参照のこと。

connectEnd のゲッター手順は、 取得タイムスタンプの変換を this の timing info の final connection timing info の connection end time および relevant global object を this に対して実行することである。 詳細は 接続タイミング情報の記録 を参照のこと。

secureConnectionStart のゲッター手順は、 取得タイムスタンプの変換を this の timing info の final connection timing info の secure connection start time および relevant global object を this に対して実行することである。 詳細は 接続タイミング情報の記録 を参照のこと。

nextHopProtocol のゲッター手順は、 isomorphic decode を this の timing info の final connection timing info の ALPN で交渉されたプロトコル に対して実行することである。詳細は 接続タイミング情報の記録 を参照のこと。

Issue 221 は、 nextHopProtocol のサポートを削除することを提案している。これはユーザーのネットワーク構成に関する詳細を 明かしてしまう可能性があるためである。

requestStart のゲッター手順は、 取得タイムスタンプの変換を this の timing info の final network-request start time および relevant global object を this に対して実行することである。詳細は HTTP fetch を参照のこと。

firstInterimResponseStart の ゲッター手順は、 取得タイムスタンプの変換を this の timing info の first interim network-response start time および relevant global object を this に対して実行することである。詳細は HTTP fetch を参照のこと。

finalResponseHeadersStart の ゲッター手順は、 取得タイムスタンプの変換を this の timing info の final network-response start time および relevant global object を this に対して実行することである。詳細は HTTP fetch を参照のこと。

responseStart のゲッター手順は、 this の firstInterimResponseStart が 0 でない場合はそれを返し、なければ this の finalResponseHeadersStart を返す。

responseEnd のゲッター手順は 取得タイムスタンプの変換を this の timing info の end time および relevant global object を this に対して実行することである。詳細は fetch を参照のこと。

encodedBodySize のゲッター手順は、 this の resource info の encoded size を返すことである。

decodedBodySize のゲッター手順は、 this の resource info の decoded size を返すことである。

transferSize のゲッター手順は：

1. もしこのオブジェクトの cache mode が "local" であれば、0 を返す。

2. もし cache mode が "validated" であれば、300 を返す。

3. 上記でない場合、このオブジェクトの resource info の encoded size に 300 を加えた値を返す。

   transferSize に加えられる定数は、HTTP ヘッダの合計バイト数を公開する代わりのものであり、それにより特定のクッキーの存在が露見することを避けます。詳細は この issue を参照してください。

responseStatus の getter 手順は、このオブジェクトの response status を返します。

responseStatus は Fetch で決定されます。クロスオリジンの no-cors リクエストの場合、レスポンスは opaque filtered response となるため 0 になります。

contentType の getter 手順は、このオブジェクトの resource info の content type を返します。

contentEncoding の getter 手順は、このオブジェクトの resource info の content encoding を返します。

renderBlockingStatus の getter 手順は、このオブジェクトの timing info の render-blocking が true であれば blocking を返し、そうでなければ non-blocking を返します。

workerRouterEvaluationStart の getter 手順は、timing info の service worker timing info の worker router evaluation start を返します。

workerCacheLookupStart の getter 手順は、timing info の service worker timing info の worker cache lookup start を返します。

workerMatchedRouterSource の getter 手順は、timing info の service worker timing info の worker matched router source を返します。

workerFinalRouterSource の getter 手順は、timing info の service worker timing info の worker final router source を返します。

PerformanceResourceTiming を実装するユーザーエージェントは "resource" を supportedEntryTypes に含める必要があります。 これにより開発者は Resource Timing のサポートを検出できます。

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

3.4. Extensions to the Performance Interface

ユーザーエージェントは Performance Timeline に含める PerformanceResourceTiming オブジェクトの数を制限することを選択してもよく、 この節は Performance インターフェイスを拡張して保存される PerformanceResourceTiming オブジェクトの数を制御するための手段を提供します。

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

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

• 初期値が 250 以上であるべき resource timing buffer size limit。
• 初期値が 0 の resource timing buffer current size。
• 初期値が false の resource timing buffer full event pending flag。
• 初期値が 0 の resource timing secondary buffer current size。
• 初期は空であり PerformanceResourceTiming オブジェクトを格納するための resource timing secondary buffer。

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

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

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

1. performance entry buffer 内の全ての PerformanceResourceTiming オブジェクトを削除する。
2. resource timing buffer current size を 0 に設定する。

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

1. resource timing buffer size limit を maxSize 引数に設定する。もし maxSize が resource timing buffer current size より小さい場合は、performance entry buffer から PerformanceResourceTiming オブジェクトを削除しない。

属性 onresourcetimingbufferfull は下記の resourcetimingbufferfull イベントのイベントハンドラです。

リソースタイミングエントリを追加できるか を確認するには、次の手順を実行する：

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

PerformanceResourceTiming エントリ new entry を パフォーマンスエントリバッファ に追加するには、次の手順を実行する：

1. リソースタイミングエントリを追加できるか が true を返し、 リソースタイミングバッファが満杯のイベントの保留フラグ が false の場合、次のサブステップを実行する：
   1. new entry を パフォーマンスエントリバッファ に追加する。
   2. リソースタイミングバッファの現在のサイズ を 1 増やす。
   3. return する。
2. リソースタイミングバッファが満杯のイベントの保留フラグ が false の場合、次のサブステップを実行する：
   1. リソースタイミングバッファが満杯のイベントの保留フラグ に true を設定する。
   2. タスクをキューする を パフォーマンスタイムラインタスクソース 上で実行し バッファ満杯イベントを発火する を実行する。
3. new entry を リソースタイミング二次バッファ に追加する。
4. リソースタイミング二次バッファの現在のサイズ を 1 増やす。

二次バッファをコピーする には、次の手順を実行する：

1. リソースタイミング二次バッファ が空でなく、 リソースタイミングエントリを追加できるか が true を返す間、次のサブステップを実行する：
   1. entry を最も古い PerformanceResourceTiming として リソースタイミング二次バッファ から取得する。
   2. entry を パフォーマンスエントリバッファ の末尾に追加する。
   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の呼び出しにより） 必要があります。

3.5. Cross-origin Resources

3.6. Resource Timing Attributes

この節は非規範的です。

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