DeprecationReportBody

Note: This feature is available in Web Workers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The DeprecationReportBody interface of the Reporting API represents the body of a deprecation report.

A deprecation report is generated when a deprecated feature (for example a deprecated API method) is used on a document being observed by a ReportingObserver. In addition to the support of this API, receiving useful deprecation warnings relies on browser vendors adding these warnings for deprecated features.

ReportBody DeprecationReportBody

Constructor

An instance of DeprecationReportBody is returned as the value of Report.body when Report.Type is deprecation. The interface has no constructor.

Instance properties

This interface also inherits properties from ReportBody.

DeprecationReportBody.id Experimental

A string representing the feature or API that is deprecated, for example NavigatorGetUserMedia. This can be used to group reports by deprecated feature.

DeprecationReportBody.anticipatedRemoval Experimental

A Date object (rendered as a string) representing the date when the feature is expected to be removed from the current browser. If the date is not known, this property will return null.

DeprecationReportBody.message Experimental

A string containing a human-readable description of the deprecation, including information such as what newer feature has superseded it, if any. This typically matches the message a browser will display in its DevTools console when a deprecated feature is used, if one is available.

DeprecationReportBody.sourceFile Experimental

A string containing the path to the source file where the deprecated feature was used, if known, or null otherwise.

DeprecationReportBody.lineNumber Experimental

A number representing the line in the source file in which the deprecated feature was used, if known, or null otherwise.

DeprecationReportBody.columnNumber Experimental

A number representing the column in the source file in which the deprecated feature was used, if known, or null otherwise.

Instance methods

This interface also inherits methods from ReportBody.

DeprecationReportBody.toJSON() Experimental

A serializer which returns a JSON representation of the InterventionReportBody object.

Examples

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

js
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 using ReportingObserver.observe(); this tells the observer to start collecting reports in its report queue, and runs the callback function specified inside the constructor:

js
observer.observe();

Because of the event handler we set up inside the ReportingObserver() constructor, we can now click the button to display the report details.

image of a jolly bearded man with various stats displayed below it about a deprecated feature

The report details are displayed via the displayReports() function, which takes the observer callback's reports parameter as its parameter:

js
function displayReports(reports) {
  const outputElem = document.querySelector(".output");
  const list = document.createElement("ul");
  outputElem.appendChild(list);

  reports.forEach((report, i) => {
    const listItem = document.createElement("li");
    const textNode = document.createTextNode(
      `Report ${i + 1}, type: ${report.type}`,
    );
    listItem.appendChild(textNode);
    const innerList = document.createElement("ul");
    listItem.appendChild(innerList);
    list.appendChild(listItem);

    for (const [key, value] of Object.entries(report.body)) {
      const innerListItem = document.createElement("li");
      innerListItem.textContent = `${key}: ${value}`;
      innerList.appendChild(innerListItem);
    }
  });
}

The reports parameter contains an array of all the reports in the observer's report queue. We loop over each report using a basic for loop, then iterate over each entry of in the report's body (a DeprecationReportBody instance) using a for...in structure, displaying each key/value pair inside a list item.

Specifications

Specification
Deprecation Reporting
# deprecationreportbody

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
DeprecationReportBody
Experimental
anticipatedRemoval
Experimental
columnNumber
Experimental
id
Experimental
lineNumber
Experimental
message
Experimental
sourceFile
Experimental
toJSON
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Experimental. Expect behavior to change in the future.
User must explicitly enable this feature.

See also