Performance: getEntriesByName()-Methode

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.

Vollständige Kompatibilität anzeigen
Mehr erfahren

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die Methode getEntriesByName() gibt ein Array von PerformanceEntry-Objekten zurück, die zum Zeitpunkt des Aufrufs in der Performance-Timeline vorhanden sind und den angegebenen Namen und Typ haben.

Wenn Sie sich für Performance-Einträge bestimmter Typen interessieren, verwenden Sie getEntriesByType(). Alle Performance-Einträge erhalten Sie mit 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 nicht zurückgegeben, selbst 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

getEntriesByName(name)
getEntriesByName(name, type)

Parameter

name: Der Name der abzurufenden Einträge.
type Optional: Der Typ der abzurufenden Einträge, beispielsweise "mark". Die gültigen Eintragstypen sind unter PerformanceEntry.entryType aufgeführt.

const debugMarks = performance.getEntriesByName("debug-mark", "mark");
debugMarks.forEach((entry) => {
  console.log(`${entry.name}'s startTime: ${entry.startTime}`);
});