ReportingObserver: ReportingObserver() Konstruktor

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Der ReportingObserver()-Konstruktor der Reporting API erstellt eine neue Instanz des ReportingObserver-Objekts, die zur Sammlung und zum Zugriff auf Berichte verwendet werden kann.

Syntax

js
new ReportingObserver(callback)
new ReportingObserver(callback, options)

Parameter

callback

Eine Callback-Funktion, die ausgeführt wird, wenn der Observer beginnt, Berichte zu sammeln (d. h. über ReportingObserver.observe()). Die Callback-Funktion erhält zwei Parameter:

reports

Eine Sequenz von Report-Objekten, die die im Berichtswarteschlangen des Observers gesammelten Berichte darstellen. Dies ist wahrscheinlich der häufigste Weg, um die Berichte abzurufen.

observer

Ein Verweis auf dasselbe ReportingObserver-Objekt, das eine rekursive Sammlung von Berichten usw. ermöglicht.

options Optional

Ein Objekt, das es Ihnen ermöglicht, die Optionen für die Erstellung des Objekts festzulegen. Die verfügbaren Optionen sind:

types

Ein Array von Strings, die die Typen von Berichten repräsentieren, die von diesem Observer gesammelt werden sollen. Verfügbare Typen sind deprecation, intervention und crash (obwohl letzterer Typ in der Regel nicht über einen ReportingObserver abrufbar ist). Wenn diese Option weggelassen wird, werden alle unterstützten Typen gesammelt.

buffered

Ein Boolean, der definiert, ob die Berichte, die generiert wurden, bevor der Observer erstellt werden konnte, beobachtbar sein sollen (true) oder nicht (false).

Beispiele

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

const observer = new ReportingObserver((reports, observer) => {
  reportBtn.onclick = () => displayReports(reports);
}, options);

Spezifikationen

Specification
Reporting API
# dom-reportingobserver-reportingobserver

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch