性能：setResourceTimingBufferSize() 方法

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

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅