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