Performance: clearResourceTimings() 方法

Baseline 已廣泛支援

此功能已成熟，可跨多種裝置和瀏覽器版本使用。自 2017 年 9 月以來，它已在瀏覽器中提供。

注意：此功能在 Web Workers 中可用。

clearResourceTimings() 方法會從瀏覽器的 performance timeline 中移除所有 entryType 為 "resource" 的 performance entry，並將 performance resource data buffer 的大小設定為零。

要設定瀏覽器 performance resource data buffer 的大小，請使用 Performance.setResourceTimingBufferSize() 方法。

要接收瀏覽器資源時序緩衝區已滿的通知，請監聽 resourcetimingbufferfull 事件。

示例

清除 performance resource data buffer

要從 buffer 中移除所有 resource performance entry，請在程式碼的適當位置呼叫 clearResourceTimings()，或者將其貼上到控制檯中。

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

在使用 PerformanceObserver 物件時（尤其是當 buffered 標誌設定為 true 時），performance resource buffer 可能會很快被填滿。但是，您也可以在不清除 buffer 的情況下，使用 PerformanceObserver.takeRecords() 方法來儲存當前的 performance entry 列表並清空 performance observer。這適用於所有型別的 performance entry，而不僅僅是 "resource" entry。

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