Performance: getEntries()-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.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die Methode getEntries() gibt ein Array aller PerformanceEntry-Objekte zurück, die sich derzeit in der Performance-Timeline befinden.
Wenn Sie nur an Performance-Einträgen bestimmter Typen oder mit bestimmten Namen interessiert sind, lesen Sie die Dokumentation zu getEntriesByType() und getEntriesByName().
Hinweis:
Diese Methode benachrichtigt Sie nicht über neue Performance-Einträge. Sie erhalten nur Einträge, die sich zum Zeitpunkt des Methodenaufrufs in der Performance-Timeline befinden.
Um über neue Einträge benachrichtigt zu werden, sobald sie verfügbar sind, verwenden Sie einen PerformanceObserver.
Die folgenden Eintragstypen werden von dieser Methode nicht unterstützt und nicht zurückgegeben, selbst wenn Einträge dieser Typen 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
getEntries()
Parameter
Keine.
Rückgabewert
Ein Array von PerformanceEntry-Objekten. Die Elemente sind anhand des jeweiligen startTime-Werts chronologisch geordnet.
Beispiele
>Alle Performance-Marker und -Messungen in der Konsole ausgeben
Wenn Sie an geeigneten Stellen in Ihrem Code eigene PerformanceMark- und PerformanceMeasure-Objekte erstellt haben, können Sie sie alle wie folgt in der Konsole ausgeben:
// Example markers/measures
performance.mark("login-started");
performance.mark("login-finished");
performance.mark("form-sent");
performance.mark("video-loaded");
performance.measure("login-duration", "login-started", "login-finished");
const entries = performance.getEntries();
entries.forEach((entry) => {
if (entry.entryType === "mark") {
console.log(`${entry.name}'s startTime: ${entry.startTime}`);
}
if (entry.entryType === "measure") {
console.log(`${entry.name}'s duration: ${entry.duration}`);
}
});
Spezifikationen
| Spezifikation |
|---|
| Performance Timeline> # dom-performance-getentries> |