Leistung: `getEntries()`-Methode

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: 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:

Um auf Einträge dieser Typen zuzugreifen, müssen Sie stattdessen einen PerformanceObserver verwenden.

Syntax

js
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:

js
// 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

Specification
Performance Timeline
# dom-performance-getentries

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch