Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

ReportingObserver

Baseline 2026
Neu verfügbar
*

Seit März 2026 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.

* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Mit der ReportingObserver-Schnittstelle der Reporting API können Sie Berichte erfassen und darauf zugreifen.

Konstruktor

ReportingObserver()

Erstellt eine neue ReportingObserver-Objektinstanz, mit der Sie Berichte erfassen und darauf zugreifen können.

Instanzeigenschaften

Für diese Schnittstelle sind keine Eigenschaften definiert.

Instanzmethoden

ReportingObserver.disconnect()

Verhindert, dass ein zuvor gestarteter Reporting Observer weitere Berichte erfasst.

ReportingObserver.observe()

Weist einen Reporting Observer an, Berichte in seiner Berichtswarteschlange zu erfassen.

ReportingObserver.takeRecords()

Gibt die aktuelle Liste der Berichte in der Berichtswarteschlange des Observers zurück und leert die Warteschlange.

Ereignisse

Diese Schnittstelle löst keine Ereignisse aus.

Beispiele

Deprecation-Berichte anzeigen

Dieses Beispiel zeigt, wie Sie mit einem ReportingObserver Berichte des Typs "deprecation" erfassen.

JavaScript

Zunächst erstellen wir ein neues ReportingObserver-Objekt, das auf Berichte des Typs "deprecation" wartet. Dabei übergeben wir eine Callback-Funktion, die die Berichte empfängt und protokolliert.

js
const options = {
  types: ["deprecation"],
  buffered: true,
};

const observer = new ReportingObserver((reports, observer) => {
  reports.forEach((report) => {
    // console.log(report);
    log(JSON.stringify(report, null, 2));
  });
}, options);

// Start the observer
observer.observe();

Anschließend führen wir den folgenden Code aus, der synchrones XHR verwendet (eine veraltete API). Beachten Sie, dass dieser Code erst nach dem Observer definiert wird, den er auslöst, sobald der Observer aktiv ist.

js
const xhr = new XMLHttpRequest();
xhr.open("GET", "/", false); // false = synchronous (deprecated)
xhr.send();

Ergebnisse

In Browsern, die Deprecation-Berichte unterstützen, sollte unten ein Bericht angezeigt werden. Beachten Sie, dass type den Wert "deprecation" hat.

Spezifikationen

Spezifikation
Reporting API
# interface-reporting-observer

Browser-Kompatibilität

Siehe auch