リソースの計時 — Resource Timing

`toJSON()@m は、 `PerformanceResourceTiming$I 用の`既定の~toJSON手続き$ `WEBIDL$r を走らす。 ◎ When toJSON is called, run the default toJSON steps for PerformanceResourceTiming.

`initiatorType@m 取得子~手続きは ⇒ ~RET コレの`起動元~種別$pT ◎ initiatorType getter steps are to return the initiator type for this.

注記： `initiatorType^m は、［ 資源~計時~entryが報告される，異なる何箇所 ］かで設定される — `~fetching$ `FETCH$r など。 ◎ Note The setting of initiatorType is done at the different places where a resource timing entry is reported, such as the fetch standard.

`workerStart@m 取得子~手続きは ⇒ ~RET `~fetch時刻印を変換する$( コレの`計時~報$pTの`最終-~sw開始~時刻$fT, コレに`関連な大域~obj$ ) ◎ The workerStart getter steps are to convert fetch timestamp for this's timing info's final service worker start time and the relevant global object for this.＼

更なる情報は、 `~HTTP~fetch$を見よ。 ◎ See HTTP fetch for more info.

`redirectStart@m 取得子~手続きは ⇒ ~RET `~fetch時刻印を変換する$( コレの`計時~報$pTの`~redirect開始~時刻$fT, コレに`関連な大域~obj$ ) ◎ The redirectStart getter steps are to convert fetch timestamp for this's timing info's redirect start time and the relevant global object for this.＼

更なる情報は、 `~HTTP~redirect~fetch$を見よ。 ◎ See HTTP-redirect fetch for more info.

`redirectEnd@m 取得子~手続きは ⇒ ~RET `~fetch時刻印を変換する$( コレの`計時~報$pTの`~redirect終了~時刻$fT, コレに`関連な大域~obj$ ) ◎ The redirectEnd getter steps are to convert fetch timestamp for this's timing info's redirect end time and the relevant global object for this.＼

更なる情報は、 `~HTTP~redirect~fetch$を見よ。 ◎ See HTTP-redirect fetch for more info.

`fetchStart@m 取得子~手続きは ⇒ ~RET `~fetch時刻印を変換する$( コレの`計時~報$pTの`~redirect後からの開始~時刻$fT, コレに`関連な大域~obj$ ) ◎ The fetchStart getter steps are to convert fetch timestamp for this's timing info's post-redirect start time and the relevant global object for this.＼

更なる情報は、 `~HTTP~fetch$を見よ。 ◎ See HTTP fetch for more info.

`domainLookupStart@m 取得子~手続きは ⇒ ~RET `~fetch時刻印を変換する$( コレの`計時~報$pTの`最終-接続~計時~報$fTの`~domain検索~開始~時刻$cT, コレに`関連な大域~obj$ ) ◎ The domainLookupStart getter steps are to convert fetch timestamp for this's timing info's final connection timing info's domain lookup start time and the relevant global object for this.＼

更なる情報は、 `接続~計時~報を記録する$を見よ。 ◎ See Recording connection timing info for more info.

`domainLookupEnd@m 取得子~手続きは ⇒ ~RET `~fetch時刻印を変換する$( コレの`計時~報$pTの`最終-接続~計時~報$fTの`~domain検索~終了~時刻$cT, コレに`関連な大域~obj$ ) ◎ The domainLookupEnd getter steps are to convert fetch timestamp for this's timing info's final connection timing info's domain lookup end time and the relevant global object for this.＼

更なる情報は、 `接続~計時~報を記録する$を見よ。 ◎ See Recording connection timing info for more info.

`connectStart@m 取得子~手続きは ⇒ ~RET `~fetch時刻印を変換する$( コレの`計時~報$pTの`最終-接続~計時~報$fTの`接続~開始~時刻$cT, コレに`関連な大域~obj$ ) ◎ The connectStart getter steps are to convert fetch timestamp for this's timing info's final connection timing info's connection start time and the relevant global object for this.＼

更なる情報は、 `接続~計時~報を記録する$を見よ。 ◎ See Recording connection timing info for more info.

`connectEnd@m 取得子~手続きは ⇒ ~RET `~fetch時刻印を変換する$( コレの`計時~報$pTの`最終-接続~計時~報$fTの`接続~終了~時刻$cT, コレに`関連な大域~obj$ ) ◎ The connectEnd getter steps are to convert fetch timestamp for this's timing info's final connection timing info's connection end time and the relevant global object for this.＼

更なる情報は、 `接続~計時~報を記録する$を見よ。 ◎ See Recording connection timing info for more info.

`secureConnectionStart@m 取得子~手続きは ⇒ ~RET `~fetch時刻印を変換する$( コレの`計時~報$pTの`最終-接続~計時~報$fTの`~secure接続~開始~時刻$cT, コレに`関連な大域~obj$ ) ◎ The secureConnectionStart getter steps are to convert fetch timestamp for this's timing info's final connection timing info's secure connection start time and the relevant global object for this.＼

更なる情報は、 `接続~計時~報を記録する$を見よ。 ◎ See Recording connection timing info for more info.

`nextHopProtocol@m 取得子~手続きは ⇒ ~RET `同型に復号する$( コレの`計時~報$pTの`最終-接続~計時~報$fTの`折衝した~ALPN~protocol~ID$cT ) ◎ The nextHopProtocol getter steps are to isomorphic decode this's timing info's final connection timing info's ALPN negotiated protocol.＼

更なる情報は、 `接続~計時~報を記録する$を見よ。 ◎ See Recording connection timing info for more info.

`requestStart@m 取得子~手続きは ⇒ ~RET `~fetch時刻印を変換する$( コレの`計時~報$pTの`最終-~network要請~開始~時刻$fT, コレに`関連な大域~obj$ ) ◎ The requestStart getter steps are to convert fetch timestamp for this's timing info's final network-request start time and the relevant global object for this.＼

注記： 更なる情報は、 `~HTTP~fetch$を見よ。 ◎ See HTTP fetch for more info.

`firstInterimResponseStart@m 取得子~手続きは ⇒ ~RET `~fetch時刻印を変換する$( コレの`計時~報$pTの`最初の非最終-~network応答~開始~時刻$fT, コレに`関連な大域~obj$ ) ◎ The firstInterimResponseStart getter steps are to convert fetch timestamp for this's timing info's first interim network-response start time and the relevant global object for this.＼

注記： 更なる情報は、 `~HTTP~fetch$を見よ。 ◎ See HTTP fetch for more info.

`finalResponseHeadersStart@m 取得子~手続きは ⇒ ~RET `~fetch時刻印を変換する$( コレの`計時~報$pTの`最終-~network応答~開始~時刻$fT, コレに`関連な大域~obj$ ) ◎ The finalResponseHeadersStart getter steps are to convert fetch timestamp for this's timing info's final network-response start time and the relevant global object for this.＼

更なる情報は、 `~HTTP~fetch$を見よ。 ◎ See HTTP fetch for more info.

`responseStart@m 取得子~手続きは：

1. %最初の非最終-応答~開始 ~LET コレの `firstInterimResponseStart$m
2. ~IF［ %最初の非最終-応答~開始 ~NEQ 0 ］ ⇒ ~RET %最初の非最終-応答~開始
3. ~RET コレの `finalResponseHeadersStart$m

`responseEnd@m 取得子~手続きは ⇒ ~RET `~fetch時刻印を変換する$( コレの`計時~報$pTの`終了~時刻$fT, コレに`関連な大域~obj$ ) ◎ The responseEnd getter steps are to convert fetch timestamp for this's timing info's end time and the relevant global object for this.＼

更なる情報は、 `~fetch$を見よ。 ◎ See fetch for more info.

`encodedBodySize@m 取得子~手続きは ⇒ ~RET コレの`資源~情報$pTの`符号化された~size$fT ◎ The encodedBodySize getter steps are to return this's resource info's encoded size.

`decodedBodySize@m 取得子~手続きは ⇒ ~RET コレの`資源~情報$pTの`復号した~size$fT ◎ The decodedBodySize getter steps are to return this's resource info's decoded size.

`transferSize@m 取得子~手続きは： ◎ The transferSize getter steps are to perform the following steps:

1. ~RET コレの`~cache~mode$pT に応じて ⇒＃ `local^l ならば 0 ／ `validated^l ならば 300 ／ ~ELSE_ コレの`資源~情報$pT【！response body info】の`符号化された~size$fT ~PLUS 300 † ◎ If this's cache mode is "local", then return 0. ◎ If this's cache mode is "validated", then return 300. ◎ Return this's response body info's encoded size plus 300.

   注記†： ~sizeに加算される定数 300 は、 ~HTTP~messageの`~header節$の総~byte~sizeを置換するものであり， ある種の~cookieの有無が公開されないようにするためである。 `課題 #238＠https://github.com/w3c/resource-timing/issues/238$ を見よ。 ◎ Note The constant number added to transferSize replaces exposing the total byte size of the HTTP headers, as that may expose the presence of certain cookies. See this issue.

`responseStatus@m 取得子~手続きは ⇒ ~RET コレの`応答~状態s$pT ◎ The responseStatus getter steps are to return this's response status.

注記： `responseStatus$m は`~fetch$内で決定される。 それは、 `要請$が非同一-生成元で［ `~mode$rq ~EQ `no-cors^l【！~FETCH#dom-requestmode-no-cors】 ］の場合には 0 になる — 対する応答は、 `不透明な絞込み応答$になるので。 ◎ Note responseStatus is determined in Fetch. For a cross-origin no-cors request it would be 0 because the response would be an opaque filtered response.

`contentType@m 取得子~手続きは ⇒ ~RET コレの`計時~報$pTの`内容~型$fT ◎ The contentType getter steps are to return this's resource info's content type.

`renderBlockingStatus@m 取得子~手続きは ⇒ ~RET コレの`計時~報$pTの`具現化を阻んでいるか$fTに応じて ⇒＃ ~T ならば `blocking$l ／ ~F ならば `non-blocking$l ◎ The renderBlockingStatus getter steps are to return blocking if this's timing info's render-blocking is true; otherwise non-blocking.

`clearResourceTimings()@m ~method手続きは： ◎ The method clearResourceTimings runs the following steps:

1. `処理能~entry~buffer$から 次を満たす~entryをすべて除去する ⇒ `PerformanceResourceTiming$I ~objである ◎ Remove all PerformanceResourceTiming objects in the performance entry buffer.
2. `資源~計時~bufferの現-~size$ ~SET 0 ◎ Set resource timing buffer current size to 0.

`setResourceTimingBufferSize(maxSize)@m ~method手続きは ⇒ `資源~計時~bufferの~size上限$ ~SET %maxSize ◎ The setResourceTimingBufferSize method runs the following steps: • Set resource timing buffer size limit to the maxSize parameter.＼

注記： ［ %maxSize ~LT `資源~計時~bufferの現-~size$ ］であっても，`処理能~entry~buffer$から `PerformanceResourceTiming$I ~objは除去されない。 ◎ If the maxSize parameter is less than resource timing buffer current size, no PerformanceResourceTiming objects are to be removed from the performance entry buffer.

`資源~計時~entryを追加でき@ るとは、 次が満たされることをいう ⇒ `資源~計時~bufferの現-~size$ ~LT `資源~計時~bufferの~size上限$ ◎ To check if can add resource timing entry, run the following steps: • If resource timing buffer current size is smaller than resource timing buffer size limit, return true. • Return false.

`処理能~entry~bufferに~entryを追加する@ ~algoは、 所与の ( `処理能~entry~buffer$ %~buffer, `PerformanceResourceTiming$I ~obj %新たな~entry ) に対し： ◎ To add a PerformanceResourceTiming entry new entry into the performance entry buffer, run the following steps:

1. ~IF［ `資源~計時~entryを追加でき$る ］~AND［ `資源~計時~buffer満杯~eventは処理待ちか$ ~EQ ~F ］： ◎ If can add resource timing entry returns true and resource timing buffer full event pending flag is false, run the following substeps:

   1. %~buffer に %新たな~entry を追加する ◎ Add new entry to the performance entry buffer.
   2. `資源~計時~bufferの現-~size$ ~INCBY 1 ◎ Increase resource timing buffer current size by 1.
   3. ~RET ◎ Return.

2. ~IF［ `資源~計時~buffer満杯~eventは処理待ちか$ ~EQ ~F ］： ◎ If resource timing buffer full event pending flag is false, run the following substeps:

   1. `資源~計時~buffer満杯~eventは処理待ちか$ ~SET ~T ◎ Set resource timing buffer full event pending flag to true.

   2. `~taskを~queueする$( `処理能~時列線~task~source$, 次の手続き )

      手続きは ⇒ `~buffer満杯~eventを発火する$()
      ◎ Queue a task on the performance timeline task source to run fire a buffer full event.
3. `資源~計時~副-~buffer$に %新たな~entry を付加する ◎ Add new entry to the resource timing secondary buffer. ◎ Increase resource timing secondary buffer current size by 1.

`副-~buffer内の~entryを移動する@ ~algoは： ◎ To copy secondary buffer, run the following steps:

1. %移動したか ~LET ~F ◎ ↓↓

2. ~WHILE［ `資源~計時~副-~buffer$は空でない ］~AND［ `資源~計時~entryを追加でき$る ］： ◎ While resource timing secondary buffer is not empty and can add resource timing entry returns true, run the following substeps:

   1. %~entry ~LET `資源~計時~副-~buffer$内の最初の（最も旧い） `PerformanceResourceTiming$I ~obj ◎ Let entry be the oldest PerformanceResourceTiming in resource timing secondary buffer.
   2. `処理能~entry~buffer$の末尾に %~entry を追加する ◎ Add entry to the end of performance entry buffer.
   3. `資源~計時~bufferの現-~size$ ~INCBY 1 ◎ Increment resource timing buffer current size by 1.
   4. `資源~計時~副-~buffer$から %~entry を除去する ◎ Remove entry from resource timing secondary buffer.
   5. %移動したか ~SET ~T ◎ Decrement resource timing secondary buffer current size by 1.
3. ~RET %移動したか

`~buffer満杯~eventを発火する@ ~algoは： ◎ To fire a buffer full event, run the following steps:

1. ~WHILE［ `資源~計時~副-~buffer$は空でない ］： ◎ While resource timing secondary buffer is not empty, run the following substeps:

   1. ~IF［ `資源~計時~entryを追加でき$ない ］ ⇒ `~eventを発火する$( `Performance$I ~obj, `resourcetimingbufferfull$et ) ◎ Let number of excess entries before be resource timing secondary buffer current size. ◎ If can add resource timing entry returns false, then fire an event named resourcetimingbufferfull at the Performance object.
   2. %移動したか ~LET `副-~buffer内の~entryを移動する$() ◎ Run copy secondary buffer.
   3. ~IF［ %移動したか ~EQ ~F ］ ⇒＃ `資源~計時~副-~buffer$からすべての~entryを除去する†； ~BREAK ◎ Let number of excess entries after be resource timing secondary buffer current size. ◎ If number of excess entries before is lower than or equals number of excess entries after, then remove all entries from resource timing secondary buffer, set resource timing secondary buffer current size to 0, and abort these steps.
2. `資源~計時~buffer満杯~eventは処理待ちか$ ~SET ~F ◎ Set resource timing buffer full event pending flag to false.

注記：† 移動できなかった~entryは、 ~bufferから落とされる。 開発者は、 `resourcetimingbufferfull$et ~event用の~event~handler内で， 次のいずれかをしておくべきである ⇒＃ `clearResourceTimings()$m を~callする／ `setResourceTimingBufferSize()$m を~callして，~bufferが足りるよう拡張する ◎ Note This means that if the resourcetimingbufferfull event handler does not add more room in the buffer than it adds resources to it, excess entries will be dropped from the buffer. Developers should make sure that resourcetimingbufferfull event handlers call clearResourceTimings or extend the buffer sufficiently (by calling setResourceTimingBufferSize).