PerformanceObserverEntryList: getEntriesByType() 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 getEntriesByType() Methode der PerformanceObserverEntryList gibt eine Liste von explizit beobachteten Performance-Entry-Objekten für einen gegebenen Performance-Entry-Typ zurück. Die Mitglieder der Liste werden durch die Menge der in dem Aufruf der observe()-Methode angegebenen Entry-Typen bestimmt. Die Liste steht in der Rückruffunktion des Beobachters zur Verfügung (als erster Parameter im Rückruf).

Syntax

js
getEntriesByType(type)

Parameter

type

Der Typ von Entry, der abgerufen werden soll, z. B. "mark". Die gültigen Entry-Typen sind in PerformanceEntry.entryType aufgeführt.

Rückgabewert

Eine Liste von explizit beobachteten PerformanceEntry-Objekten, die den angegebenen type haben. Die Einträge sind in chronologischer Reihenfolge basierend auf den startTime der Einträge. Wenn keine Objekte mit dem angegebenen type vorhanden sind oder kein Argument angegeben wird, 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-getentriesbytype

Browser-Kompatibilität

BCD tables only load in the browser