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

瀏覽器相容性

另見