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
イベントを待ち受けしてください。
構文
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 |
ブラウザーの互換性
BCD tables only load in the browser