Performance Timeline — パフォーマンス タイムライン

4.1. Performance Timeline の適用範囲

PerformanceResourceTiming [Resource Timing], PerformanceMark, PerformanceMeasure [User Timing] インタフェースなどの， Performance Timeline に参与するすべてのインタフェースは、次の規則に従わなければならない： All interfaces that participate in the Performance Timeline, such as the PerformanceResourceTiming [Resource Timing], PerformanceMark, and PerformanceMeasure [User Timing] interfaces, must adhere to the following rules:

• PerformanceEntry インタフェースを拡張しなければならない Must extend the PerformanceEntry interface
• getEntries, getEntriesByType, getEntriesByName メソッドによりサポートされなければならない。 Must be supported by the getEntries, getEntriesByType, and getEntriesByName methods

4.2. PerformanceEntry インタフェース

interface PerformanceEntry {
  readonly attribute DOMString name;
  readonly attribute DOMString entryType;
  readonly attribute DOMHighResTimeStamp startTime;
  readonly attribute DOMHighResTimeStamp duration;
};

DOMString name

この属性は、この PerformanceEntry オブジェクトに対する識別子を返さなければならない。 この識別子は一意的である必要はない。 The name attribute must return the identifier for this PerformanceEntry object. This identifier does not have to be unique.

DOMString entryType

この属性は、この PerformanceEntry オブジェクトで表現されるインタフェースの type を表す文字列を返さなければならない。 The entryType attribute must return a DOMString that describes the type of the interface represented by this PerformanceEntry object.

注記： Web Performance/entryType wiki ページにて，既知の entryType 値のすべてが挙げられている。 The Web Performance/entryType wiki page lists all of the known entryType values.

DOMHighResTimeStamp startTime

この属性は、このパフォーマンス計量において最初に記録されたタイムスタンプの time 値（時刻値）をとる， DOMHighResTimeStamp を返さなければならない。 The startTime attribute must return a DOMHighResTimeStamp that contains the time value of the first recorded timestamp of this performance metric.

DOMHighResTimeStamp duration

この属性は、この PerformanceEntry により記録された，事象全体の期間の time 値（時間の長さ値）をとる， DOMHighResTimeStamp を返さなければならない。 通常，これは、この PerformanceEntry において最後に記録されたタイムスタンプと, 最初に記録されたタイムスタンプとの時間差分になる。 パフォーマンス計量において，時間長の概念が適用されない場合には、 duration は 0 を返すことにしてもよい。 The duration attribute must return a DOMHighResTimeStamp that contains the time value of the duration of the entire event being recorded by this PerformanceEntry. Typically, this would be the time difference between the last recorded timestamp and the first recorded timestamp of this PerformanceEntry. A performance metric may choose to return a duration of 0, if the duration concept doesn't apply.

4.3. Performance インタフェースに対する拡張

partial interface Performance {
  PerformanceEntryList getEntries();
  PerformanceEntryList getEntriesByType(DOMString entryType);
  PerformanceEntryList getEntriesByName(DOMString name, optional DOMString entryType);
};

typedef sequence <PerformanceEntry> PerformanceEntryList;

window.performance 属性は、 Performance インタフェース [Navigation Timing] が利用する，パフォーマンスの測定に関する属性とメソッドを保持するための区域を提供する。 The window.performance attribute provides a hosting area for performance measurement related attributes and methods using the Performance interface [Navigation Timing].

PerformanceEntryList getEntries()

このメソッドは、［ すべての PerformanceEntry オブジェクトの複製を， startTime から時系列順に並べたもの ］を内容とする， PerformanceEntryList オブジェクトを返す。 The getEntries method returns a PerformanceEntryList object that contains a copy of all PerformanceEntry objects in chronological order with respect to startTime. Return value A PerformanceEntryList object.

例外は投出されない

PerformanceEntryList getEntriesByType(entryType)

このメソッドは、［ PerformanceEntry オブジェクトであって，［ その entryType 属性が entryType 引数と同じ値をとる ］もの ］すべての複製を，［ startTime から時系列順に並べたもの ］を内容とする， PerformanceEntryList オブジェクトを返す。

そのような PerformanceEntry オブジェクトが存在しない場合、返される PerformanceEntryList オブジェクトの内容は空でなければならない。

The getEntriesByType method returns a PerformanceEntryList object that contains a copy of all PerformanceEntry objects, in chronological order with respect to startTime, that have the same value for the entryType attribute of PerformanceEntry as the entryType parameter.

引数

DOMString entryType

返り値の PerformanceEntryList オブジェクトは， entryType 属性がこの引数と同じ値をとる PerformanceEntry オブジェクトの複製のみからなる。 A PerformanceEntryList object that contains a copy of PerformanceEntry objects that have the same value for the entryType attribute of PerformanceEntry as the entryType parameter. If no such PerformanceEntry objects exist, the PerformanceEntryList must be empty. Return value A PerformanceEntryList object.

例外は投出されない

PerformanceEntryList getEntriesByName(name, entryType)

このメソッドは、［ PerformanceEntry オブジェクトであって，［ その name 属性が name 引数と同じ値をとる ］, かつ［ entryType 引数が指定されている場合は その entryType 属性も entryType 引数と同じ値をとる ］もの ］すべての複製を，［ startTime から時系列順に並べたもの ］を内容とする， PerformanceEntryList オブジェクトを返す。

そのような PerformanceEntry オブジェクトが存在しない場合、返される PerformanceEntryList オブジェクトの内容は空でなければならない。

The getEntriesByName method returns a PerformanceEntryList object that contains a copy of PerformanceEntry objects, in chronological order with respect to startTime, that have the same value for the name attribute of PerformanceEntry as the name parameter and, if specified, have the same value for the entryType attribute of PerformanceEntry as the entryType parameter.

引数

DOMString name

返り値は、 name 属性がこの引数と同じ値をとる PerformanceEntry オブジェクトの複製のみからなる。 The PerformanceEntryList object that contains a copy of PerformanceEntry objects that have the same value for the name attribute of PerformanceEntry as the name parameter. If no such PerformanceEntry objects exist, the PerformanceEntryList must be empty.

DOMString entryType

この引数も与えられた場合、返り値を構成する PerformanceEntry オブジェクト（の複製）は entryType 属性もこの引数と同じ値をとるものに限られる。 The PerformanceEntryList object that only contains a copy of PerformanceEntry objects that have the same value for the entryType attribute of PerformanceEntry as the entryType parameter and have the same value for the name attribute of PerformanceEntry as the name parameter. If no such PerformanceEntry objects exist, the PerformanceEntryList must be empty. Return value A PerformanceEntryList object.

例外は投出されない

4.4. ベンダ拡張子

試験的な PerformanceEntryList オブジェクトを作成するために，ベンダ固有のプロプライエタリ UA 拡張が必要になった場合、 entryType IDL 属性の被取得時には、ベンダは，次の規約に従う DOMString を返さなければならない： If a vendor-specific proprietary user agent extension is needed to create experimental PerformanceEntry objects, on getting the entryType IDL attribute, vendors MUST return a DOMString that uses the following convention:

[vendorprefix]-[entrytype]

ここで： Where,

• [vendorprefix] は、ベンダを識別する大文字化されていない名前であり， [vendorprefix] is a non-capitalized name that identifies the vendor,
• [entrytype] は、 この PerformanceEntry オブジェクトにより表現されるインタフェースの type に付与される，大文字化されていない名前であり， [entrytype] is a non-capitalized name given to the type of the interface represented by this PerformanceEntry object,
• 上のいずれの名前も ASCII とする。 and the above names are in ASCII.