Newly available Newly available. Verify your target environments before adopting.

Reporting API

The ReportingObserver interface of the Reporting API allows you to collect and access reports.

Observers and Performance

Browser support

Feature Desktop Mobile
Chrome
Edge
Firefox
Safari
Chrome Android
Safari iOS
ReportingObserver
69
79
149
16.4
69
16.4
disconnect

The disconnect() method of the ReportingObserver interface stops a reporting observer that had previously started observing from collecting reports.
69
79
149
16.4
69
16.4
observe

The observe() method of the ReportingObserver interface instructs a reporting observer to start collecting reports in its report queue.
69
79
149
16.4
69
16.4
ReportingObserver

The ReportingObserver() constructor of the Reporting API creates a new ReportingObserver object instance, which can be used to collect and access reports.
69
79
149
16.4
69
16.4
ReportingObserver (options parameter)

`options` parameter
69
79
149
16.4
69
16.4
ReportingObserver (options parameter types property)

`types_property` property
69
79
149
16.4
69
16.4
ReportingObserver (options parameter types property coep)

`coep` report
69
79
69
ReportingObserver (options parameter types property csp-violation)

The CSPViolationReport dictionary of the Reporting API represents a report that is generated when a document violates its Content Security Policy (CSP).
74
79
149
18.4
74
18.4
ReportingObserver (options parameter types property deprecation)

The DeprecationReport dictionary of the Reporting API represents a deprecation report.
69
79
149
69
ReportingObserver (options parameter types property integrity-violation)

The IntegrityViolationReport dictionary of the Reporting API represents a report that is generated when a document violates its Integrity Policy.
138
138
149
138
ReportingObserver (options parameter types property intervention)
Experimental

The InterventionReport dictionary of the Reporting API represents an intervention report.
69
79
69
takeRecords

The takeRecords() method of the ReportingObserver interface returns the current list of reports contained in the observer's report queue, and empties the queue.
69
79
149
16.4
69
16.4
worker_support

Available in workers
84
84
149
84
Other
Reporting-Endpoints

The HTTP Reporting-Endpoints response header allows website administrators to specify one or more endpoints that can be sent reports generated by the Reporting API.
96
96
149
16.4
96
16.4
1+Supported (version) Not supported ※Has note Sub-feature descriptions sourced from MDN Web Docs (CC BY-SA 2.5)
Notes 2 item(s)
Limitation
  • This browser only partially implements this feature
Implementation note
  • Not supported in workers

Use cases

  • Using Reporting API

    The ReportingObserver interface of the Reporting API allows you to collect and access reports.

Cautions

  • May not be supported in older browsers.

Implementation notes

  • Some APIs require a secure context (HTTPS) or user activation. Check the requirements before use.

Related links