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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
clearResourceTimings

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Requires a vendor prefix or different name for use.
Has more compatibility info.

Siehe auch