Performance: getEntriesByType() メソッド

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2017年9月以降、すべてのブラウザーで利用可能です。

getEntriesByType() メソッドは、現在パフォーマンスタイムラインにある、指定された型の PerformanceEntry オブジェクトの配列を返します。

特定の名前のパフォーマンス項目に関心がある場合は、 getEntriesByName() を参照してください。すべてのパフォーマンス項目の場合は、 getEntries() を参照してください。

メモ: このメソッドは新しいパフォーマンス項目を通知しません。このメソッドを呼び出した時点でパフォーマンスタイムラインに存在している項目のみを取得します。利用できるようになった項目の通知を受け取るには、 PerformanceObserver を使用してください。

以下の項目型はこのメソッドではまったく対応しておらず、これらの型の項目が存在したとしても返されません。

"element" (PerformanceElementTiming)
"event" (PerformanceEventTiming)
"largest-contentful-paint" (LargestContentfulPaint)
"layout-shift" (LayoutShift)
"longtask" (PerformanceLongTaskTiming)

これらの型の項目にアクセスするには、代わりに PerformanceObserver を使用する必要があります。

構文

getEntriesByType(type)

引数

type: 取得する項目の型。 "mark" など。有効な項目型は PerformanceEntry.entryType に掲載されています。対応している entryTypes は、静的プロパティ PerformanceObserver.supportedEntryTypes を使用して取得することができます。

const resources = performance.getEntriesByType("resource");
resources.forEach((entry) => {
  console.log(`${entry.name}'s startTime: ${entry.startTime}`);
});