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 |
Browser-Kompatibilität
Loading…