User Timing — （日本語訳）

◎要約

この仕様は、高-精度な時刻印への~accessを与えることにより，~web開発者は自身の~appの処理能を測定するのを支援するための~interfaceを定義する。 ◎ This specification defines an interface to help web developers measure the performance of their applications by giving them access to high precision timestamps.

1. 序論

◎非規範的

~web開発者は、 ~appの処理能~特性について，［ ~accessする能, 理解する能］を必要とする。 ~JS `ECMA-262$r は、 ~appの待時間を測定する仕組み（ `Date.now()^m ~methodで現在の時刻印を検索取得する）を供するが、この時刻印の精度は~UAによってまちまちである。 ◎ Web developers need the ability to assess and understand the performance characteristics of their applications. While JavaScript [ECMA-262] provides a mechanism to measure application latency (retrieving the current timestamp from the Date.now() method), the precision of this timestamp varies between user agents.

この文書は、高-精度かつ単調増加する時刻印を公開する［ `PerformanceMark$I, `PerformanceMeasure$I ］~interfaceを定義し， `Performance$I ~interfaceを拡張して、開発者が~appの処理能をより良く測定できるようにする。 ◎ This document defines the PerformanceMark and PerformanceMeasure interfaces, and extensions to the Performance interface, which expose a high precision, monotonically increasing timestamp so that developers can better measure the performance characteristics of their applications.

次の~scriptに，開発者が~scriptに関係する計時~dataを得するために、この文書で定義される~interfaceを利用する例を示す： ◎ The following script shows how a developer can use the interfaces defined in this document to obtain timing data related to developer scripts. ◎ Example 1

async function run() {
  performance.mark("startTask1");
  await doTask1(); /* 
何らかの開発者~code
◎
Some developer code
 */
  performance.mark("endTask1");

  performance.mark("startTask2");
  await doTask2(); /* 
何らかの開発者~code
◎
Some developer code
 */
  performance.mark("endTask2");

  /* 
~logに出す
◎
Log them out
 */
  const %entries = performance.getEntriesByType("mark");
  for (const %entry of %entries) {
    console.table(%entry.toJSON());
  }
}
run();

`PERFORMANCE-TIMELINE-2$r は、記録された計量を検索取得するときに利用できる 2 つの仕組みを定義する：

［ `getEntries()$m, `getEntriesByType()$m ］~methodは、ある時点の特定0の計量を名前で検索取得するときに最も適する。
`PerformanceObserver$I ~interfaceは、新たな計量が可用になり次第，その通知を受取る場合に最適化されている。

◎ Note ◎ [PERFORMANCE-TIMELINE-2] defines two mechanisms that can be used to retrieve recorded metrics: getEntries() and getEntriesByType() methods, and the PerformanceObserver interface. The former is best suited for cases where you want to retrieve a particular metric by name at a single point in time, and the latter is optimized for cases where you may want to receive notifications of new metrics as they become available.

別の例として、ある %component を~~包装する要素は［ ~clickされたとき、何らかの新たな内容を~fetchして，~fetchされたことを指示する］とする。ここでは、利用者が~clickしてから~fetchが完了するまでにかかった時間を報告したい。［ ~click~handlerが実行される時刻］を~markするのでは，その~eventが処理される【~handlerに渡される】までの待時間を取りこぼすことになるので、代わりに~eventの~hardware時刻印【 `timeStamp$m 】を利用する。また，より詳細な解析を得るため、 %component の名前も知りたい。 ◎ As another example, suppose that there is an element which, when clicked, fetches some new content and indicates that it has been fetched. We'd like to report the time from when the user clicked to when the fetch was complete. We can't mark the time the click handler executes since that will miss latency to process the event, so instead we use the event hardware timestamp. We also want to know the name of the component to have more detailed analytics. ◎ Example 2

%element.addEventListener("click", %e => {
  const %component = getComponent(%element);
  fetch(%component.url).then(() => {
    %element.textContent = "Updated";
    const %updateMark = performance.mark("update_component", {
      detail: {component: %component.name},
    });
    performance.measure("click_to_update_component", {
      detail: {component: %component.name},
      start: %e.timeStamp,
      end: %updateMark.startTime,
    });
  });
});

2. 適合性

【この節の内容は ~W3C日本語訳共通~page に移譲。】

【この訳に特有な表記規約】

◎表記記号

3. 利用元~計時

3.1. `Performance^I ~interfaceに対する拡張

［ `Performance$I ~interface, `DOMHighResTimeStamp$I 型］は `HR-TIME-2$r にて定義される。 `PerformanceEntry$I ~interfaceは `PERFORMANCE-TIMELINE-2$r にて定義される。 ◎ The Performance interface and DOMHighResTimeStamp are defined in [HR-TIME-2]. The PerformanceEntry interface is defined in [PERFORMANCE-TIMELINE-2].

dictionary `PerformanceMarkOptions$I {
  `any$ `detail$mkO;
  `DOMHighResTimeStamp$ `startTime$mkO;
};

dictionary `PerformanceMeasureOptions$I {
  `any$ `detail$msO;
  (`DOMString$ or `DOMHighResTimeStamp$) `start$msO;
  `DOMHighResTimeStamp$ `duration$msO;
  (`DOMString$ or `DOMHighResTimeStamp$) `end$msO;
};

partial interface `Performance$I {
  `PerformanceMark$I `mark$m(
      `DOMString$ %markName,
      optional `PerformanceMarkOptions$I %markOptions = {}
  );
  `undefined$ `clearMarks$m(optional `DOMString$ %markName);
  `PerformanceMeasure$I `measure$m(
      `DOMString$ %measureName,
      optional (`DOMString$ or `PerformanceMeasureOptions$I) %startOrMeasureOptions = {},
      optional `DOMString$ %endMark
  );
  `undefined$ `clearMeasures$m(optional `DOMString$ %measureName);
};

`mark(markName, markOptions)@m ~methodは、時刻印に所与の名前（ “~mark” ）を結付けて格納する。 ◎ 3.1.1 mark() method ◎ Stores a timestamp with the associated name (a "mark").

その~method手続きは： ◎ It MUST run these steps:

%~entry ~LET `PerformanceMark()$m 構築子の手続きを ( %markName, %markOptions ) を引数に走らせた結果 ◎ Run the PerformanceMark constructor and let entry be the newly created object.
`処理能~entryを~queueする$( %~entry ) ◎ Queue entry.
`処理能~entry~buffer$に %~entry を追加する ◎ Add entry to the performance entry buffer.
~RET %~entry ◎ Return entry.

%markOptions に与える `PerformanceMarkOptions@I 辞書の： ◎ 3.1.1.1 PerformanceMarkOptions dictionary

`detail@mkO ~memberは、 ~mark内に含めることになる~metadataを与える。 ◎ detail • Metadata to be included in the mark.
`startTime@mkO ~memberは、 ~mark時刻として利用される時刻印を与える。 ◎ startTime • Timestamp to be used as the mark time.

`clearMarks(markName)@m ~methodは、格納-済み時刻印のうち，所与の名前が結付けられたものを除去する。 ◎ 3.1.2 clearMarks() method ◎ Removes the stored timestamp with the associated name.＼

その~method手続きは ⇒ `処理能~entry~buffer$から，次を満たす `PerformanceMark$I ~objすべてを除去する ⇒ %markName は与えられていないならば無条件／ ~ELSE_ `name$m ~EQ %markName なるもの ◎ It MUST run these steps: • If markName is omitted, remove all PerformanceMark objects from the performance entry buffer. • Otherwise, remove all PerformanceMark objects listed in the performance entry buffer whose name is markName. • Return undefined.

`measure(measureName, startOrMeasureOptions, endMark)@m ~methodは、 2 つの~markの間の所要時間（ “測定n” ）を表す `DOMHighResTimeStamp$I 値に所与の名前を結付けて格納する。 ◎ 3.1.3 measure() method ◎ Stores the DOMHighResTimeStamp duration between two marks along with the associated name (a "measure").

その~method手続きは： ◎ It MUST run these steps:

( %始端, %終端, %所要時間, %detail ) ~LET ( ε, ε, ε, ε ) ◎ ↓
~IF［ %startOrMeasureOptions は `PerformanceMeasureOptions$I ~objである］：
1. %始端 ~SET %startOrMeasureOptions[ "`start$msO" ]
2. %終端 ~SET %startOrMeasureOptions[ "`end$msO" ]
3. %所要時間 ~SET %startOrMeasureOptions[ "`duration$msO" ]
4. %detail ~SET %startOrMeasureOptions[ "`detail$msO" ]
5. ~IF［ ~AND↓ ］…
  - ［ %始端 ~NEQ ε ］~OR［ %終端 ~NEQ ε ］~OR［ %所要時間 ~NEQ ε ］~OR［ %detail ~NEQ ε ］
  - ~OR↓：
    - %endMark ~NEQ ε
    - ［ %始端 ~EQ ε ］~AND［ %終端 ~EQ ε ］
    - ［ %始端 ~NEQ ε ］~AND［ %終端 ~NEQ ε ］~AND［ %所要時間 ~NEQ ε ］
  …ならば ⇒ ~THROW `TypeError$E
◎ If startOrMeasureOptions is a PerformanceMeasureOptions object and at least one of start, end, duration, and detail exist, run the following checks: • If endMark is given, throw a TypeError. • If startOrMeasureOptions's start and end members are both omitted, throw a TypeError. • If startOrMeasureOptions's start, duration, and end members all exist, throw a TypeError.
%終端~時刻 ~LET 次の手続きを走らせた結果： ◎ Compute end time as follows:
1. ~IF［ %endMark ~NEQ ε ］ ⇒ ~RET `~markを時刻印に変換する$( %endMark ) ◎ If endMark is given, let end time be the value returned by running the convert a mark to a timestamp algorithm passing in endMark.
2. ~IF［ %終端 ~NEQ ε ］ ⇒ ~RET `~markを時刻印に変換する$( %終端 ) ◎ Otherwise, if startOrMeasureOptions is a PerformanceMeasureOptions object, and if its end member exists, let end time be the value returned by running the convert a mark to a timestamp algorithm passing in startOrMeasureOptions's end.
3. ~IF［ %始端 ~NEQ ε ］~AND［ %所要時間 ~NEQ ε ］： ◎ Otherwise, if startOrMeasureOptions is a PerformanceMeasureOptions object, and if its start and duration members both exist:
  1. %始端 ~SET `~markを時刻印に変換する$( %始端 ) ◎ Let start be the value returned by running the convert a mark to a timestamp algorithm passing in start.
  2. %所要時間 ~SET `~markを時刻印に変換する$( %所要時間 ) ◎ Let duration be the value returned by running the convert a mark to a timestamp algorithm passing in duration.
  3. ~RET %始端 ~PLUS %所要時間 ◎ Let end time be start plus duration.
4. ~RET `現在の高分解能~時刻$ ◎ Otherwise, let end time be the value that would be returned by the Performance object's now() method.
%始端~時刻 ~LET 次の手続きを走らせた結果： ◎ Compute start time as follows:
1. ~IF［ %始端 ~NEQ ε ］ ⇒ ~RET `~markを時刻印に変換する$( %始端 ) ◎ If startOrMeasureOptions is a PerformanceMeasureOptions object, and if its start member exists, let start time be the value returned by running the convert a mark to a timestamp algorithm passing in startOrMeasureOptions's start.
2. ~IF［ %所要時間 ~NEQ ε ］~AND［ %終端 ~NEQ ε ］： ◎ Otherwise, if startOrMeasureOptions is a PerformanceMeasureOptions object, and if its duration and end members both exist:
  1. %所要時間 ~SET `~markを時刻印に変換する$( %所要時間 ) ◎ Let duration be the value returned by running the convert a mark to a timestamp algorithm passing in duration.
  2. %終端 ~SET `~markを時刻印に変換する$( %終端 ) ◎ Let end be the value returned by running the convert a mark to a timestamp algorithm passing in end.
  3. ~RET %終端 ~MINUS %所要時間 ◎ Let start time be end minus duration.
3. ~IF［ %startOrMeasureOptions は `DOMString$I である］ ⇒ ~RET `~markを時刻印に変換する$( %startOrMeasureOptions ) ◎ Otherwise, if startOrMeasureOptions is a DOMString, let start time be the value returned by running the convert a mark to a timestamp algorithm passing in startOrMeasureOptions.
4. ~RET 0 ◎ Otherwise, let start time be 0.
%~entry ~LET コレに`関連な~realm$に属する，新たな `PerformanceMeasure$I ~obj ◎ Create a new PerformanceMeasure object (entry) with this's relevant realm.
%~entry の ⇒＃ `name$m ~SET %measureName, `entryType$m ~SET `measure^l, `startTime$m ~SET %始端~時刻, `duration$m ~SET %終端~時刻 ~MINUS %始端~時刻（負にもなり得る）, `detail$mS ~SET ~NULL ◎ Set entry's name attribute to measureName. ◎ Set entry's entryType attribute to DOMString "measure". ◎ Set entry's startTime attribute to start time. ◎ Set entry's duration attribute to the duration from start time to end time. The resulting duration value MAY be negative. ◎ ↓
~IF［ %detail ~NEQ ε ］ ⇒ %~entry の `detail$mS ~SET `StructuredDeserialize$jA( `StructuredSerialize$jA( %detail ), `現在の~realm$ ) ◎ Set entry's detail attribute as follows: • If startOrMeasureOptions is a PerformanceMeasureOptions object and startOrMeasureOptions's detail member exists: •• Let record be the result of calling the StructuredSerialize algorithm on startOrMeasureOptions's detail. •• Set entry's detail to the result of calling the StructuredDeserialize algorithm on record and the current realm. • Otherwise, set it to null.
`処理能~entryを~queueする$( %~entry ) ◎ Queue entry.
`処理能~entry~buffer$に %~entry を追加する ◎ Add entry to the performance entry buffer.
~RET %~entry ◎ Return entry.

%startOrMeasureOptions に与える `PerformanceMeasureOptions@I 辞書の： ◎ 3.1.3.1 PerformanceMeasureOptions dictionary

`detail@msO ~memberは、 ~mark内に含めることになる~metadataを与える。 ◎ detail • Metadata to be included in the measure.
`start@msO ~memberは、［始端~時刻として利用されることになる時刻印／始端~markとして利用されることになる文字列］を与える。 ◎ start • Timestamp to be used as the start time or string to be used as start mark.
`duration@msO ~memberは、始端~時刻から終端~時刻までの所要時間を与える。 ◎ duration • Duration between the start and end times.
`end@msO ~memberは、［終端~時刻として利用されることになる時刻印／終端~markとして利用されることになる文字列］を与える。 ◎ end • Timestamp to be used as the end time or string to be used as end mark.

`clearMeasures(measureName)@m ~methodは、所与の名前が結付けられた，格納-済み時刻印を除去する。 ◎ 3.1.4 clearMeasures() method ◎ Removes stored timestamp with the associated name.＼

その~method手続きは ⇒ `処理能~entry~buffer$から，次を満たす `PerformanceMeasure$I ~objすべてを除去する ⇒ %measureName は与えられていないならば無条件／ ~ELSE_ `name$m ~EQ %measureName なるもの ◎ It MUST run these steps: • If measureName is omitted, remove all PerformanceMeasure objects in the performance entry buffer. • Otherwise remove all PerformanceMeasure objects listed in the performance entry buffer whose name is measureName. • Return undefined.

3.2. `PerformanceMark^I ~interface

`PerformanceMark$I ~interfaceは、 `Performance$I ~interfaceの `mark()$m ~methodを介して作成された~markも`処理能~時列線$に公開する。 ◎ The PerformanceMark interface also exposes marks created via the Performance interface's mark() method to the Performance Timeline.

[`Exposed$=(Window,Worker)]
interface `PerformanceMark@I : `PerformanceEntry$I {
  `PerformanceMark$mc(`DOMString$ %markName, optional `PerformanceMarkOptions$I %markOptions = {});
  readonly attribute `any$ `detail$mK;
};

`PerformanceMark$I ~interfaceは、 `PerformanceEntry$I ~interfaceの次に挙げる属性を拡張する： ◎ The PerformanceMark interface extends the following attributes of the PerformanceEntry interface:

`name$m は、 ~mark名を返すモノトスル。 ◎ The name attribute must return the mark's name.
`entryType$m は、文字列 `mark^l を返すモノトスル。 ◎ The entryType attribute must return the DOMString "mark".
`startTime$m は、 ~markの時刻を表す `DOMHighResTimeStamp$I 値を返すモノトスル。 ◎ The startTime attribute must return a DOMHighResTimeStamp with the mark's time value.
`duration$m は、 `DOMHighResTimeStamp$I 値 0 を返すモノトスル。 ◎ The duration attribute must return a DOMHighResTimeStamp of value 0.

【すなわち，当の~objを作成した `PerformanceMark()$m 構築子の手続き（ `mark()$m ~methodが呼出したそれも含む）にて設定された値を返す。】

`PerformanceMark$I ~interfaceは、次に挙げる［属性／構築子］も追加的に包含する： ◎ The PerformanceMark interface contains the following additional attribute:

`detail@mK 取得子~手続きは、コレの構築-時に `PerformanceMarkOptions$I 辞書から複製された値を返す。 ◎ The detail attribute must return the value it is set to (it's copied from the PerformanceMarkOptions dictionary).

`PerformanceMark(markName, markOptions)@m 構築子~手続きは： ◎ 3.2.1 The PerformanceMark Constructor ◎ The PerformanceMark constructor must run the following steps:

~IF［ `現在の大域~obj$は `Window$I ~objである］~AND［ %markName は `PerformanceTiming$I ~interface内のある【！読専】属性の名前である］ ⇒ ~THROW `SyntaxError$E ◎ If the current global object is a Window object and markName uses the same name as a read only attribute in the PerformanceTiming interface, throw a SyntaxError.
~Assert：コレは`現在の大域~obj$の`~realm$gLに属する ◎ Create a new PerformanceMark object (entry) with the current global object's realm.
コレの `name$m ~SET %markName ◎ Set entry's name attribute to markName.
コレの `entryType$m ~SET `mark^l ◎ Set entry's entryType attribute to DOMString "mark".
コレの `startTime$m ~SET 次の手続きを走らせた結果
1. %開始~時刻 ~SET %markOptions[ "`startTime$mkO" ]
2. ~IF［ %開始~時刻 ~EQ ε ］ ⇒ ~RET `現在の高分解能~時刻$
3. ~IF［ %開始~時刻 ~LT 0 ］ ⇒ ~THROW `TypeError$E
4. ~RET %開始~時刻
◎ Set entry's startTime attribute as follows: • If markOptions's startTime member exists, then: •• If markOptions's startTime is negative, throw a TypeError. •• Otherwise, set entry's startTime to the value of markOptions's startTime. • Otherwise, set it to the value that would be returned by the Performance object's now() method.
コレの `duration$m ~SET 0 ◎ Set entry's duration attribute to 0.
%detail ~LET %markOptions[ "`detail$mkO" ] ◎ ↓
コレの `detail$mK ~SET %detail に応じて ⇒＃ ~NULL ならば ~NULL ／ ~ELSE_ `StructuredDeserialize$jA( `StructuredSerialize$jA( %detail ), `現在の~realm$ ) ◎ If markOptions's detail is null, set entry's detail to null. ◎ Otherwise: • Let record be the result of calling the StructuredSerialize algorithm on markOptions's detail. • Set entry's detail to the result of calling the StructuredDeserialize algorithm on record and the current realm.

3.3. `PerformanceMeasure^I ~interface

`PerformanceMeasure$I ~interfaceは、 `Performance$I ~interfaceの `measure()$m ~methodを介して作成された測定nも`処理能~時列線$に公開する。 ◎ The PerformanceMeasure interface also exposes measures created via the Performance interface's measure() method to the Performance Timeline.

[`Exposed$=(Window,Worker)]
interface `PerformanceMeasure@I : `PerformanceEntry$I {
  readonly attribute `any$ `detail$mS;
};

`PerformanceMeasure$I ~interfaceは、 `PerformanceEntry$I ~interfaceの次に挙げる属性を拡張する： ◎ The PerformanceMeasure interface extends the following attributes of the PerformanceEntry interface:

`name$m は、この測定nの名前を返すモノトスル。 ◎ The name attribute must return the measure's name.
`entryType$m は、文字列 `measure^l を返すモノトスル。 ◎ The entryType attribute must return the DOMString "measure".
`startTime$m は、この測定nの始端~markの時刻を表す `DOMHighResTimeStamp$I 値を返すモノトスル。 ◎ The startTime attribute must return a DOMHighResTimeStamp with the measure's start mark.
`duration$m は、この測定nの所要時間を表す `DOMHighResTimeStamp$I 値を返すモノトスル。 ◎ The duration attribute must return a DOMHighResTimeStamp with the duration of the measure.

【すなわち，当の~objを作成した `measure()$m ~methodにて設定された値を返す。】

`PerformanceMeasure$I ~interfaceは、次の属性も追加的に包含する： ◎ The PerformanceMeasure interface contains the following additional attribute:

`detail@mS 取得子~手続きは、コレの作成-時に `PerformanceMeasureOptions$I 辞書から複製された値を返す。 ◎ The detail attribute must return the value it is set to (it's copied from the PerformanceMeasureOptions dictionary).

4. 処理

注記： `User Timing^cite ~APIを実装する~UAは、その~supportを開発者が検出できるよう， `supportedEntryTypes$m 内に `mark^l, `measure^l を含める必要がある。 ◎ Note A user agent implementing the User Timing API would need to include "mark" and "measure" in supportedEntryTypes. This allows developers to detect support for User Timing.

`~markを時刻印に変換する@ ときは、所与の ( 文字列または `DOMHighResTimeStamp$I %~mark ) に対し， %~mark の型に応じて，次の手続きを走らす： ◎ 4.1 Convert a mark to a timestamp ◎ To convert a mark to a timestamp, given a mark that is a DOMString or DOMHighResTimeStamp run these steps:＼

`DOMString$I

~IF［ %~mark は `PerformanceTiming$I ~interface内のある【！読専】属性の名前である］ ⇒ ~RET `名前を時刻印に変換する$( %~mark ) ◎ If mark is a DOMString and it has the same name as a read only attribute in the PerformanceTiming interface, let end time be the value returned by running the convert a name to a timestamp algorithm with name set to the value of mark.
~IF［ `処理能~entry~buffer$内の `PerformanceMark$I ~objに［その `name$m 属性の値 ~EQ %名前］なるものはある］ ⇒ ~RET それらの~objの `startTime$m 属性~値のうち，最も近過去を指す値 ◎ Otherwise, if mark is a DOMString, let end time be the value of the startTime attribute from the most recent occurrence of a PerformanceMark object in the performance entry buffer whose name is mark.＼
~THROW `SyntaxError$E ◎ If no matching entry is found, throw a SyntaxError.

`DOMHighResTimeStamp^I ◎ Otherwise, if mark is a DOMHighResTimeStamp:

~IF［ %~mark ~LT 0 ］ ⇒ ~THROW `TypeError$E ◎ If mark is negative, throw a TypeError.
~RET %~mark ◎ Otherwise, let end time be mark.

`名前を時刻印に変換する@ ときは、所与の ( %名前 ) に対し，次の手続きを走らす： ◎ 4.2 Convert a name to a timestamp ◎ To convert a name to a timestamp given a name＼

~Assert： %名前は `PerformanceTiming$I ~interface内のある【！読専】属性の名前である ◎ that is a read only attribute in the PerformanceTiming interface, run these steps:
~IF［ `大域~obj$【！現在の大域~obj？】は `Window$I ~objでない］ ⇒ ~THROW `TypeError$E ◎ If the global object is not a Window object, throw a TypeError.
~IF［ %名前 ~EQ `navigationStart^l ］ ⇒ ~RET 0 ◎ If name is navigationStart, return 0.
%始端~時刻 ~LET `PerformanceTiming$I ~interfaceの `navigationStart$m 値 ◎ Let startTime be the value of navigationStart in the PerformanceTiming interface.
%終端~時刻 ~LET `PerformanceTiming$I ~interfaceの %名前属性の値 ◎ Let endTime be the value of name in the PerformanceTiming interface.
~IF［ %終端~時刻 ~EQ 0 ］ ⇒ ~THROW `InvalidAccessError$E ◎ If endTime is 0, throw an InvalidAccessError.
~RET %終端~時刻 ~MINUS %始端~時刻 ◎ Return result of subtracting startTime from endTime.

注記： `NAVIGATION-TIMING$r にて定義される `PerformanceTiming$I ~interfaceは、今や廃用にされたものと見なされている。 `PerformanceTiming$I ~interfaceからの名前の利用は，後方-互換であり続けるよう~supportされるが、将来に，この機能性を `NAVIGATION-TIMING-2$r に定義される `PerformanceNavigationTiming$I （あるいは他の~interface）内の名前にまで拡張する計画は無い。 ◎ Note The PerformanceTiming interface was defined in [NAVIGATION-TIMING] and is now considered obsolete. The use of names from the PerformanceTiming interface is supported to remain backwards compatible, but there are no plans to extend this functionality to names in the PerformanceNavigationTiming interface defined in [NAVIGATION-TIMING-2] (or other interfaces) in the future.

5. 推奨される~mark名

開発者には、共通的な計時を［次に挙げる推奨される~mark名を利用して~markする］ことが奨励される。 `~UA$は、これらの名前の用法が［適切かどうか／当の名前の記述と一貫であるかどうか］を検証しない。 ◎ Developers are encouraged to use the following recommended mark names to mark common timings. The user agent does not validate that the usage of these names is appropriate or consistent with its description.

注記：そのような推奨される~mark名を追加することは、［処理能~toolが~site向け指導を誂える］ための助けになり得る。これらの~mark名は、［本物の利用者を監視している~provider／~UA ］が［ ~web開発者たちによる，自身の~appの処理能に関する通達］を大規模に収集して，その情報を［ ~siteに特有な作業を要求することなく開発者に表面化する］ための助けにもなり得る。 ◎ Adding such recommended mark names can help performance tools tailor guidance to a site. These mark names can also help real user monitoring providers and user agents collect web developer signals regarding their application's performance at scale, and surface this information to developers without requiring any site-specific work.

`mark_fully_loaded@l

当の~pageが全部的に読込まれたものと見なされる時刻 — 開発者が自身の~appにて~markしたとおり。 ◎ The time when the page is considered fully loaded as marked by the developer in their application.

【！class="note"】

次の例では、 ~pageは，読込ngに際してある［ `chat widget^en, `searchbox^en, `newsfeed^en ］を非同期的に初期化する。 ~mark名 `mark_fully_loaded$l は、それが完遂したとき［研究用~toolや解析~provider ］が当の計時を自動的に示すことを可能化する。 ◎ In this example, the page asynchonously initializes a chat widget, a searchbox, and a newsfeed upon loading. When finished, the "mark_fully_loaded" mark name enables lab tools and analytics providers to automatically show the timing.

window.addEventListener("load", (%event) => {
  Promise.all([
    loadChatWidget(),
    initializeSearchAutocomplete(),
    initializeNewsfeed()]).then(() => {
      performance.mark('mark_fully_loaded');
  });
});

`mark_fully_visible@l

当の~pageが末端-利用者に全部的に可視になったと見なされる時刻 — 開発者が自身の~appにて~markしたとおり。 ◎ The time when the page is considered fully visible to an end-user as marked by the developer in their application.

`mark_interactive@l

当の~pageが末端-利用者とヤリトリ-可能になったと見なされる時刻 — 開発者が自身の~appにて~markしたとおり。 ◎ The time when the page is considered interactive to an end-user as marked by the developer in their application.

`mark_feature_usage@l

処理能に影響iし得る特能の用法を~markする — ~tool法や解析がそれを織り込めるよう。 `detail$mK ~metadataは、当の特能について有用な情報として，次に挙げる~memberを包含し得る： ◎ Mark the usage of a feature which may impact performance so that tooling and analytics can take it into account. The detail metadata can contain any useful information about the feature, including:

`feature@c ⇒ 利用された特能の名前。 ◎ The name of the feature used.
`framework@c ⇒ 適用-可能な場合、当の特能は，どの下層の~framework用に意図されたものか — ~JS~framework, 内容~管理~system, 電子商取引~platform など。 ◎ If applicable, the underlying framework the feature is intended for, such as a JavaScript framework, content management system, or e-commerce platform.

【！class="note"】

次の~code例は、画像を~sizeして最適な処理能を得るために， ~framework `FancyJavaScriptFramework^c 用の特能 `ImageOptimizationComponent^c が利用されたことを注記する — それが処理能を改善する助けになったかどうか，研究用~toolや解析が測定できるよう。 ◎ In this example, the ImageOptimizationComponent for FancyJavaScriptFramework is used to size images for optimal performance. The code notes this feature's usage so that lab tools and analytics can measure whether it helped improve performance.

performance.mark('mark_feature_usage', {
  'detail': {
    'feature': 'ImageOptimizationComponent',
    'framework': 'FancyJavaScriptFramework'
  }
})

5. ~privacyと~security

◎非規範的

この仕様に定義される~interfaceは、 ~page上の特定の~JS活動を感知し得る計時~情報を公開する。高分解能な計時~情報を公開する際の~privacyと~securityの考慮点については `HR-TIME-2$r を~~参照されたし。 ◎ The interfaces defined in this specification expose potentially sensitive timing information on specific JavaScript activity of a page. Please refer to [HR-TIME-2] for privacy and security considerations of exposing high-resolution timing information.

~web~platformは，［同じ~pageに含められたどの~scriptも、各~scriptの生成元に関わらず，同じ~accessを有する］という不変則の下に設計されているので、この仕様に定義される~interfaceは，［計時~情報を記録する／記録された計時~情報を検索取得する］ときに制約を課すものではない。すなわち，~pageに含められた~scriptにより記録された利用元~計時~markや測定nは、同じ~pageで走っている他のどの~scriptからも，その生成元に関わらず読取れる。 ◎ Because the web platform has been designed with the invariant that any script included on a page has the same access as any other script included on the same page, regardless of the origin of either scripts, the interfaces defined by this specification do not place any restrictions on recording or retrieval of recorded timing information - i.e. a user timing mark or measure recorded by any script included on the page can be read by any other script running on the same page, regardless of origin.

謝辞

この仕事に貢献された次の方々に感謝する：

Thanks to James Simonsen, Jason Weber, Nic Jansma, Philippe Le Hegaret, Karen Anderson, Steve Souders, Sigbjorn Vik, Todd Reifsteck, and Tony Gentilcore for their contributions to this work.