TheReportingObserver interface of theReporting API allows you to collect and access reports.

Constructor

ReportingObserver()

Creates a newReportingObserver object instance, which can be used to collect and access reports.

Instance properties

This interface has no properties defined on it.

Instance methods

ReportingObserver.disconnect()

Stops a reporting observer that had previously started observing from collecting reports.

ReportingObserver.observe()

Instructs a reporting observer to start collecting reports in its report queue.

ReportingObserver.takeRecords()

Returns the current list of reports contained in the observer's report queue, and empties the queue.

Events

This interface has no events that fire on it.

Examples

In ourdeprecation_report.html example, we create a simple reporting observer to observe usage of deprecated features on our web page:

const options = {  types: ["deprecation"],  buffered: true,};const observer = new ReportingObserver((reports, observer) => {  reportBtn.onclick = () => displayReports(reports);}, options);

We then tell it to start observing reports usingReportingObserver.observe(); this tells the observer to start collecting reports in its report queue, and runs the callback function specified inside the constructor:

observer.observe();

Later on in the example we deliberately use the deprecated version ofMediaDevices.getUserMedia():

if (navigator.mozGetUserMedia) {  navigator.mozGetUserMedia(constraints, success, failure);} else {  navigator.getUserMedia(constraints, success, failure);}

This causes a deprecation report to be generated; because of the event handler we set up inside theReportingObserver() constructor, we can now click the button to display the report details.

Specifications

Browser compatibility

See also

• Reporting API