Leistung: 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 getEntries()-Methode gibt ein Array aller PerformanceEntry-Objekte zurück, die derzeit in der Leistungschronologie vorhanden sind.
Wenn Sie nur an Leistungsdatensätzen bestimmter Typen oder mit bestimmten Namen interessiert sind, siehe getEntriesByType() und getEntriesByName().
Hinweis:
Diese Methode benachrichtigt Sie nicht über neue Leistungsdatensätze; Sie erhalten nur Datensätze, die zum Zeitpunkt des Aufrufs dieser Methode in der Leistungschronologie vorhanden sind.
Um Benachrichtigungen über Datensätze zu erhalten, sobald sie verfügbar werden, verwenden Sie einen PerformanceObserver.
Die folgenden Eintragstypen werden von dieser Methode überhaupt nicht unterstützt und werden nicht zurückgegeben, selbst wenn Einträge für diese Typen existieren könnten:
"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 in chronologischer Reihenfolge basierend auf der startTime der Einträge angeordnet.
Beispiele
>Protokollierung aller Leistungsmarker und -messungen
Angenommen, Sie haben Ihre eigenen PerformanceMark- und PerformanceMeasure-Objekte an geeigneten Stellen in Ihrem Code erstellt, möchten Sie möglicherweise alle an die Konsole protokollieren, wie folgt:
// 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> |