Performance: setResourceTimingBufferSize() 方法

Baseline 已广泛支持

此功能已成熟,可跨多种设备和浏览器版本使用。自 2017 年 9 月以来,它已在浏览器中提供。

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

setResourceTimingBufferSize() 方法用于设置浏览器资源计时缓冲区的大小,该缓冲区存储 "resource" 性能条目。

规范要求资源计时缓冲区初始大小为 250 或更大。

要清除浏览器的性能资源数据缓冲区,请使用 Performance.clearResourceTimings() 方法。

要接收浏览器资源时序缓冲区已满的通知,请监听 resourcetimingbufferfull 事件。

语法

js
setResourceTimingBufferSize(maxSize)

参数

maxSize

一个 number,表示浏览器应在其性能条目缓冲区中保留的 PerformanceEntry 对象的数量上限。

返回值

无(undefined)。

示例

设置资源计时缓冲区大小

以下调用允许在浏览器性能时间线上保留 500 个 "resource" 性能条目。

js
performance.setResourceTimingBufferSize(500);

如果您将缓冲区大小设置为一个小于缓冲区中当前条目数量的数字,则不会删除任何条目。相反,要清除缓冲区,请调用 Performance.clearResourceTimings()

js
performance.getEntriesByType("resource").length; // 20
performance.setResourceTimingBufferSize(10);
performance.getEntriesByType("resource").length; // 20

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

规范

规范
资源时序
# dom-performance-setresourcetimingbuffersize

浏览器兼容性

另见