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 2017年9月.
clearResourceTimings() メソッドは、entryType が "resource" のすべてのパフォーマンス項目をブラウザーのパフォーマンスタイムラインから削除し、パフォーマンスリソースデータバッファーのサイズをゼロに設定します。
ブラウザーのリソースデータバッファーのサイズを設定するには、Performance.setResourceTimingBufferSize() メソッドを使用してください。
ブラウザーのリソースタイミングバッファーがいっぱいになったときに通知を取得するには、 resourcetimingbufferfull イベントを待ち受けしてください。
構文
clearResourceTimings()
引数
なし。
返値
なし (undefined)。
例
パフォーマンスリソースバッファーをクリア
すべてのリソースパフォーマンス項目をバッファーから除去するには、コードの適切な位置で 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();
仕様書
| Specification |
|---|
| Resource Timing # dom-performance-clearresourcetimings |
ブラウザーの互換性
Loading…