PerformanceObserverEntryList: 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: Dieses Feature ist verfügbar in Web Workers.

Die getEntries()-Methode des PerformanceObserverEntryList-Interfaces gibt eine Liste von explizit beobachteten Performance-Eintrag Objekten zurück. Die Mitglieder der Liste werden durch den Satz von Eintragstypen bestimmt, der im Aufruf der observe()-Methode angegeben wurde. Die Liste ist in der Callback-Funktion des Beobachters verfügbar (als erster Parameter im Callback).

Syntax

js
getEntries()

Rückgabewert

Eine Liste von explizit beobachteten PerformanceEntry-Objekten. Die Einträge sind in chronologischer Reihenfolge basierend auf der startTime der Einträge. Wenn keine Objekte gefunden werden, wird eine leere Liste zurückgegeben.

Beispiele

Arbeiten mit getEntries, getEntriesByName und getEntriesByType

Das folgende Beispiel zeigt den Unterschied zwischen den Methoden getEntries(), getEntriesByName() und getEntriesByType().

js
const observer = new PerformanceObserver((list, obs) => {
  // Log all entries
  let perfEntries = list.getEntries();
  perfEntries.forEach((entry) => {
    console.log(`${entry.name}'s duration: ${entry.duration}`);
  });

  // Log entries named "debugging" with type "measure"
  perfEntries = list.getEntriesByName("debugging", "measure");
  perfEntries.forEach((entry) => {
    console.log(`${entry.name}'s duration: ${entry.duration}`);
  });

  // Log entries with type "mark"
  perfEntries = list.getEntriesByType("mark");
  perfEntries.forEach((entry) => {
    console.log(`${entry.name}'s startTime: ${entry.startTime}`);
  });
});

// Subscribe to various performance event types
observer.observe({
  entryTypes: ["mark", "measure", "navigation", "resource"],
});

Spezifikationen

Specification
Performance Timeline
# dom-performanceobserverentrylist-getentries

Browser-Kompatibilität

BCD tables only load in the browser