Leistung: Methode setResourceTimingBufferSize()

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: Dieses Feature ist verfügbar in Web Workers.

Die Methode setResourceTimingBufferSize() legt die gewünschte Größe des Resource Timing Puffers des Browsers fest, der die "resource" Performance-Einträge speichert.

Die Spezifikation erfordert, dass der Resource Timing Puffer anfangs 250 oder größer ist.

Um den Performance-Resource-Datenpuffer des Browsers zu löschen, verwenden Sie die Methode Performance.clearResourceTimings().

Um benachrichtigt zu werden, wenn der Resource Timing Puffer des Browsers voll ist, hören Sie auf das resourcetimingbufferfull-Ereignis.

Syntax

js
setResourceTimingBufferSize(maxSize)

Parameter

maxSize

Eine number, die die maximale Anzahl von PerformanceEntry-Objekten darstellt, die der Browser in seinem Performance-Eintragspuffer halten soll.

Rückgabewert

Kein (undefined).

Beispiele

Einstellen der Größe des Resource Timing Puffers

Folgender Aufruf erlaubt 500 "resource" Performance-Einträge in der Performance-Zeitleiste des Browsers.

js
performance.setResourceTimingBufferSize(500);

Wenn Sie die Puffergröße auf eine Zahl kleiner als die Anzahl der aktuellen Einträge im Puffer setzen, werden keine Einträge entfernt. Um den Puffer stattdessen zu löschen, rufen Sie Performance.clearResourceTimings() auf.

js
performance.getEntriesByType("resource").length; // 20
performance.setResourceTimingBufferSize(10);
performance.getEntriesByType("resource").length; // 20

performance.clearResourceTimings();
performance.getEntriesByType("resource").length; // 0

Spezifikationen

Specification
Resource Timing
# dom-performance-setresourcetimingbuffersize

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch