性能:clearResourceTimings() 方法

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

规范

规范
资源计时
# dom-performance-clearresourcetimings

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅