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.

* Some parts of this feature may have varying levels of support.

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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
PerformanceObserver
PerformanceObserver() constructor
droppedEntriesCount() parameter
Experimental
disconnect
observe
supportedEntryTypes() static method
takeRecords
Available in workers

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Experimental. Expect behavior to change in the future.
Has more compatibility info.

Siehe auch