Performance: Methode getEntriesByType()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2017 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die Methode getEntriesByType() gibt ein Array von PerformanceEntry-Objekten zurück, die sich zum Zeitpunkt des Aufrufs für einen bestimmten Typ in der Performance-Timeline befinden.
Wenn Sie Performance-Einträge mit einem bestimmten Namen suchen, lesen Sie die Dokumentation zu getEntriesByName(). Informationen zu allen Performance-Einträgen finden Sie unter getEntries().
Hinweis:
Diese Methode benachrichtigt Sie nicht über neue Performance-Einträge. Sie erhalten nur Einträge, die zum Zeitpunkt des Aufrufs in der Performance-Timeline vorhanden sind.
Um Benachrichtigungen zu erhalten, sobald Einträge verfügbar werden, verwenden Sie einen PerformanceObserver.
Die folgenden Eintragstypen werden von dieser Methode nicht unterstützt und daher auch dann nicht zurückgegeben, wenn entsprechende Einträge vorhanden sind:
"container"(PerformanceContainerTiming)"element"(PerformanceElementTiming)"event"(PerformanceEventTiming)"largest-contentful-paint"(LargestContentfulPaint)"layout-shift"(LayoutShift)"longtask"(PerformanceLongTaskTiming)
Um auf Einträge dieser Typen zuzugreifen, müssen Sie stattdessen einen PerformanceObserver verwenden.
Syntax
getEntriesByType(type)
Parameter
type-
Der Typ der abzurufenden Einträge, beispielsweise
"mark". Die gültigen Eintragstypen sind unterPerformanceEntry.entryTypeaufgeführt. Die unterstütztenentryTypeskönnen über die statische EigenschaftPerformanceObserver.supportedEntryTypesabgerufen werden.
Rückgabewert
Ein Array von PerformanceEntry-Objekten mit dem angegebenen type. Die Elemente sind anhand des startTime-Werts der Einträge chronologisch geordnet. Wenn keine Objekte den angegebenen type haben oder kein Argument übergeben wird, wird ein leeres Array zurückgegeben.
Beispiele
Ressourceneinträge protokollieren
Das folgende Beispiel protokolliert alle Einträge des Typs "resource".
const resources = performance.getEntriesByType("resource");
resources.forEach((entry) => {
console.log(`${entry.name}'s startTime: ${entry.startTime}`);
});
Spezifikationen
| Spezifikation |
|---|
| Performance Timeline # dom-performance-getentriesbytype |