Skip to content

Reporting: there's no complete list of possible report types (or named reporting endpoints) #43688

@ddbeck

Description

@ddbeck

MDN URL

https://developer.mozilla.org/en-US/docs/Web/API/Reporting_API

What specific section or headline is this issue about?

Report types [but also others]

What information was incorrect, unhelpful, or incomplete?

I could not find a complete list report types (or at least the current text doesn't tell me if the listed report types are exhaustive).

What did you expect to see?

On this page, I expected to find a complete list of all the possible values for a report body's type property. Short of that, I expected to be able to piece together the list from the ReportingObserver: observe() method page and the Reporting-Endpoints header page.

Likewise, I expected to find a complete list of named reporting endpoints (e.g., Reporting-Endpoints: crash-reporting="…"), plus the default endpoint.

Without this information, it's very difficult to know what reports one might expect to receive via the ReportingObserver API or via POST to a Reporting-Endpoints: default="…" header URL.

Finally, I would also expect to see an explicit enumeration of which reports types go to reporting endpoints, the ReportingObserver API, or both.

Do you have any supporting links, references, or citations?

The Report types section says:

The type of report can be determined from its type property, which for the reports above would be coep, deprecation, integrity-violation, intervention and csp-violation.

It does not say whether "the reports above" is an exhaustive list of report types.

The relevant specs are in a deeply confused state, so it's not easy to determine this from the specifications (see w3c/reporting#216 (comment) and that issue in general for more information).

Do you have anything more you want to share?

No response

MDN metadata

Page report details

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions