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 2015.

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

js
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.

js
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.

js
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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch