Performance: clearResourceTimings() method
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.
Note: This feature is available in Web Workers.
The clearResourceTimings()
method removes all performance entries with an entryType
of "resource"
from the browser's performance timeline and sets the size of the performance resource data buffer to zero.
To set the size of the browser's performance resource data buffer, use the
Performance.setResourceTimingBufferSize()
method.
To get notified when the browser's resource timing buffer is full, listen for the resourcetimingbufferfull
event.
Syntax
clearResourceTimings()
Parameters
None.
Return value
None (undefined
).
Examples
Clearing the performance resource data buffer
To remove all resource performance entries from the buffer, call the clearResourceTimings()
at an appropriate point in your code or paste it into the console.
performance.clearResourceTimings();
performance.getEntriesByType("resource").length; // 0
Taking records and emptying performance observers
When using PerformanceObserver
objects (especially with the buffered
flag set to true
), the performance resource buffer might get full quickly. However, instead of clearing the buffer, you can also store the current list of performance entries and empty the performance observer using the PerformanceObserver.takeRecords()
method. This works with all kinds of performance entry types, not just "resource"
entries.
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();
Specifications
Specification |
---|
Resource Timing # dom-performance-clearresourcetimings |
Browser compatibility
BCD tables only load in the browser