PerformanceEntry
オブジェクトは、パフォーマンスタイムラインの一部である単一のパフォーマンスメトリックをカプセル化します。パフォーマンスエントリは、アプリケーション内の明示的な時点でパフォーマンス mark
または measure
を作成する (たとえば、mark()
メソッドを呼び出すことによって) ことで直接作成できます。パフォーマンスエントリは、(イメージなどの) リソースのロードなどの間接的な方法でも作成されます。
PerformanceEntry
インスタンスは常に次のサブタイプのいずれかになります:
PerformanceMark
PerformanceMeasure
PerformanceFrameTiming
PerformanceNavigationTiming
PerformanceResourceTiming
PerformancePaintTiming
注:
この機能は Web Worker 内で利用可能です。プロパティ
PerformanceEntry.name
読取専用PerformanceEntry.entryType
プロパティによって返される値をさらに指定する値。両方の値はサブタイプによって異なります。有効な値についてはプロパティページを参照してください。PerformanceEntry.entryType
読取専用- たとえば、"
mark
" などのパフォーマンスメトリックの種類を表すDOMString
。有効な値についてはプロパティページを参照してください。 PerformanceEntry.startTime
読取専用- パフォーマンスメトリックの開始時間を表す
DOMHighResTimeStamp
。 PerformanceEntry.duration
読取専用- パフォーマンスイベントの期間の時間値を表す
DOMHighResTimeStamp
。
メソッド
PerformanceEntry.toJSON()
PerformanceEntry
オブジェクトの JSON リプリゼンテーションを返します。
例
次の例では、すべての PerformanceEntry
プロパティを調べて、ブラウザがそれらをサポートしているかどうかを確認し、サポートしている場合はそれらの値をコンソールに書き込みます。
function print_PerformanceEntries() {
// getEntries() を使用してすべてのパフォーマンスエントリのリストを取得します。
var p = performance.getEntries();
for (var i=0; i < p.length; i++) {
console.log("PerformanceEntry[" + i + "]");
print_PerformanceEntry(p[i]);
}
}
function print_PerformanceEntry(perfEntry) {
var properties = ["name",
"entryType",
"startTime",
"duration"];
for (var i=0; i < properties.length; i++) {
// それぞれのプロパティをチェックします。
var supported = properties[i] in perfEntry;
if (supported) {
var value = perfEntry[properties[i]];
console.log("... " + properties[i] + " = " + value);
} else {
console.log("... " + properties[i] + " is NOT supported");
}
}
}
仕様
仕様書 | ステータス | コメント |
---|---|---|
Resource Timing Level 3 | 編集者草案 | |
Resource Timing Level 2 | 草案 | |
Resource Timing Level 1 | 勧告候補 | PerformanceResourceTiming インターフェイスと entryType の resource 値を追加します。 |
Navigation Timing Level 2 | 草案 | |
Navigation Timing | 勧告 | PerformanceNavigationTiming インターフェイスと entryType の navigation 値を追加します。 |
User Timing Level 2 | 草案 | |
User Timing | 勧告 | entryType の mark および measure の値と同様に、PerformanceMark および PerformanceMeasure インターフェイスを追加します。 |
Frame Timing | ドラフト | PerformanceFrameTiming インターフェイスと entryType の frame 値を追加します。 |
Performance Timeline Level 2 PerformanceEntry の定義 |
勧告候補 | toJSON() シリアライザメソッドを追加しました。 |
Performance Timeline PerformanceEntry の定義 |
勧告 | 初期定義 |
ブラウザの互換性
BCD tables only load in the browser