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 March 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.

Das ReportingObserver-Interface der Reporting API ermöglicht es Ihnen, Berichte zu sammeln und zuzugreifen.

Konstruktor

ReportingObserver()

Erstellt eine neue ReportingObserver-Objektinstanz, die verwendet werden kann, um Berichte zu sammeln und auf sie zuzugreifen.

Instanz-Eigenschaften

Dieses Interface hat keine definierten Eigenschaften.

Instanz-Methoden

ReportingObserver.disconnect()

Stoppt einen Reporting Observer, der zuvor mit dem Sammeln von Berichten begonnen hatte.

ReportingObserver.observe()

Weist einen Reporting Observer an, mit dem Sammeln von Berichten in seiner Berichtswarteschlange zu beginnen.

ReportingObserver.takeRecords()

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

Ereignisse

Dieses Interface hat keine Ereignisse, die darauf ausgeführt werden.

Beispiele

Anzeigen von Veraltungsberichten

Dieses Beispiel zeigt, wie man "deprecation"-Berichte mithilfe eines ReportingObserver beobachtet.

JavaScript

Zuerst konstruieren wir ein neues ReportingObserver-Objekt, um Berichte mit dem Typ "deprecation" zu empfangen, und übergeben einen Callback, der 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();

Wir rufen dann den folgenden Code auf, der synchrones XHR (veraltete API) verwendet. Beachten Sie, dass dies nach dem Observer definiert ist, den es auslöst, sobald der Observer läuft.

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

Ergebnisse

In Browsern, die Veraltungsberichte unterstützen, sollte unten ein Bericht angezeigt werden. Beachten Sie, dass der type "deprecation" ist.

Spezifikationen

Spezifikation
Reporting API
# interface-reporting-observer

Browser-Kompatibilität

Siehe auch