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