Performance: clearResourceTimings() メソッド

Baseline 広く利用可能

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

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

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

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

例

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

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

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

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

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();