Performance: clearResourceTimings() Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die clearResourceTimings() Methode entfernt alle Performance-Einträge mit einem entryType von "resource" aus der Performance-Timeline des Browsers und setzt die Größe des Performance-Ressourcen-Datenpuffers auf null.
Um die Größe des Ressourcen-Datenpuffers des Browsers festzulegen, verwenden Sie die Performance.setResourceTimingBufferSize() Methode.
Um benachrichtigt zu werden, wenn der Ressourcen-Timing-Puffer des Browsers voll ist, hören Sie auf das resourcetimingbufferfull Ereignis.
Syntax
clearResourceTimings() Parameter
Keine.
Rückgabewert
Keine (undefined).
Beispiele
Leeren des Performance-Ressourcen-Datenpuffers
Um alle Ressourcen-Performance-Einträge aus dem Puffer zu entfernen, rufen Sie clearResourceTimings() zu einem geeigneten Zeitpunkt in Ihrem Code auf oder fügen Sie es in die Konsole ein.
performance.clearResourceTimings(); performance.getEntriesByType("resource").length; // 0 Aufzeichnen von Einträgen und Leeren von Performance-Observern
Bei der Verwendung von PerformanceObserver Objekten (insbesondere mit dem buffered-Flag auf true gesetzt), kann der Performance-Ressourcen-Puffer schnell voll werden. Anstatt den Puffer zu leeren, können Sie jedoch auch die aktuelle Liste der Performance-Einträge speichern und den Performance-Observer mit der PerformanceObserver.takeRecords() Methode leeren. Diese Methode funktioniert mit allen Arten von Performance-Einträgen, nicht nur mit "resource" Einträgen.
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(); Spezifikationen
| Specification |
|---|
| Resource Timing # dom-performance-clearresourcetimings |