ReportingObserver()
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The ReportingObserver()
constructor of the Reporting API creates a new ReportingObserver
object instance, which can be used to collect and access reports.
Syntax
new ReportingObserver(callback[, options]);
Parameters
callback
-
A callback function that runs when the observer starts to collect reports (i.e. via
ReportingObserver.observe()
). The callback function is given two parameters:-
reports
: A sequence ofReport
objects representing the reports collected in the observer's report queue. This is probably the most common way to retrieve the reports. -
observer
: A reference to the sameReportingObserver
object, allowing for recursive report collection, etc.
-
-
options
Optional -
An
ReportingObserverOptions
object allowing you to set the options for creating the object. The available options are:-
types
: An array of strings representing the types of report to be collected by this observer. Available types includedeprecation
,intervention
, andcrash
(although this last type usually isn't retrievable via aReportingObserver
). -
buffered
: a boolean that defines whether the reports that were generated before the observer was able to be created should be observable (true
) or not (false
).
-
Examples
let options = { types: ['deprecation'], buffered: true } let observer = new ReportingObserver(function(reports, observer) { reportBtn.onclick = () => displayReports(reports); }, options);
Specifications
Specification |
---|
Reporting API # dom-reportingobserver-reportingobserver |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
ReportingObserver |
69 |
79 |
No |
No |
56 |
No |
69 |
69 |
No |
48 |
No |
10.0 |
See also
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/ReportingObserver/ReportingObserver