PerformanceObserver

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.

Das PerformanceObserver-Interface wird verwendet, um Leistungsmessevorgänge zu beobachten und über neue Performance-Einträge benachrichtigt zu werden, sobald diese in der Performance-Zeitleiste des Browsers aufgezeichnet werden.

Konstruktor

PerformanceObserver()

Erstellt und gibt ein neues PerformanceObserver-Objekt zurück.

Statische Eigenschaften

PerformanceObserver.supportedEntryTypes Schreibgeschützt

Gibt ein Array der vom Benutzeragenten unterstützten entryType-Werte zurück.

Instanzmethoden

PerformanceObserver.observe()

Gibt die zu beobachtenden Eintragstypen an. Die Callback-Funktion des Leistungsbeobachters wird aufgerufen, wenn ein Leistungs-Eintrag für einen der angegebenen entryTypes aufgezeichnet wird.

PerformanceObserver.disconnect()

Beendet die Leistung des Beobachters, um Leistungs-Einträge zu empfangen.

PerformanceObserver.takeRecords()

Gibt die aktuelle Liste der im Leistungsbeobachter gespeicherten Leistungs-Einträge zurück und leert diese.

Beispiele

Erstellung eines PerformanceObserver

Das folgende Beispiel erstellt einen PerformanceObserver, der auf "mark" (PerformanceMark) und "measure" (PerformanceMeasure) Ereignisse achtet. Der Callback perfObserver liefert eine list (PerformanceObserverEntryList), die Ihnen ermöglicht, beobachtete Leistungs-Einträge abzurufen.

js
function perfObserver(list, observer) {
  list.getEntries().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}`);
    }
  });
}
const observer = new PerformanceObserver(perfObserver);
observer.observe({ entryTypes: ["measure", "mark"] });

Spezifikationen

Specification
Performance Timeline
# dom-performanceobserver

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch