Performance: clearResourceTimings() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.

clearResourceTimings() メソッドは、entryType が "resource" のすべてのパフォーマンス項目をブラウザーのパフォーマンスタイムラインから削除し、パフォーマンスリソースデータバッファーのサイズをゼロに設定します。

ブラウザーのリソースデータバッファーのサイズを設定するには、Performance.setResourceTimingBufferSize() メソッドを使用してください。

ブラウザーのリソースタイミングバッファーがいっぱいになったときに通知を取得するには、 resourcetimingbufferfull イベントを待ち受けしてください。

構文

js
clearResourceTimings()

引数

なし。

返値

なし (undefined)。

パフォーマンスリソースバッファーをクリア

すべてのリソースパフォーマンス項目をバッファーから除去するには、コードの適切な位置で clearResourceTimings() を呼び出すか、コンソールに貼り付けてください。

js
performance.clearResourceTimings();
performance.getEntriesByType("resource").length; // 0

記録を取り、パフォーマンスオブザーバーを空にする

PerformanceObserver オブジェクトを使用する場合(特に buffered フラグを true に設定した場合)、パフォーマンスリソースバッファーがすばやくいっぱいになることがあります。しかし、バッファーをクリアする代わりに、現在のパフォーマンス項目のリストを格納し、 PerformanceObserver.takeRecords() メソッドを使用してパフォーマンスオブザーバーを空にすることもできます。これは "resource" 項目だけでなく、すべてのパフォーマンス項目型で動作します。

js
function perfObserver(list, observer) {
  list.getEntries().forEach((entry) => {
    // do something with the entries
  });
}
const observer = new PerformanceObserver(perfObserver);
observer.observe({ type: "resource", buffered: true });

// Store entries and empty performance observer
const records = observer.takeRecords();

仕様書

Specification
Resource Timing
# dom-performance-clearresourcetimings

ブラウザーの互換性

BCD tables only load in the browser

関連情報