Skip to content

Add crash report storage feature#3816

Draft
ddbeck wants to merge 4 commits intoweb-platform-dx:mainfrom
ddbeck:crash-report-storage
Draft

Add crash report storage feature#3816
ddbeck wants to merge 4 commits intoweb-platform-dx:mainfrom
ddbeck:crash-report-storage

Conversation

@ddbeck
Copy link
Copy Markdown
Collaborator

@ddbeck ddbeck commented Feb 25, 2026

Fixes #3468

@github-actions github-actions bot added the feature definition Creating or defining new features or groups of features. label Feb 25, 2026
@@ -0,0 +1,9 @@
name: Crash report storage
description: The `window.crashReport` object is a key-value store to record information about your application's state. If there's a crash, then the data in the key-value store is sent to your crash reporting endpoint, to help you pinpoint the cause of the crash.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this API builds on top of the Reporting API, which should likely be named here.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

After re-reading a few resources, my understanding is now that:

  1. The Reporting API is the higher-level feature, which basically consists in defining a Reporting-Endpoints header to say where the browser should send (multiple types of) reports to.
    That's https://web-platform-dx.github.io/web-features-explorer/features/reporting/

  2. On top of this, the Crash Reporting API was defined. It's an extension of the Reporting API that's specifically made for reporting crashes, and which defines that reports contain data such as reason, stack, is_top_level, visibility_state, and crash_report_api.
    Spec: https://wicg.github.io/crash-reporting/
    We don't have a feature in the repo for this.

  3. The window.crashReport object, which seems to be and extension of the Crash Reporting API that lets developers also send their own custom data along with a crash report, but creating a map of key/value pairs
    Spec: https://wicg.github.io/crash-reporting/#crash-report-storage
    That's the new crash-report-storage feature you're proposing here.

I'm not 100% confident that 2 and 3 are separate things, but they do seem this way to me.

That said, I don't know if there are BCD keys for 2.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If there are no practical benefits to creating a feature for 2 and 3, then we should at least revise the description to broaden the language so it encompasses the Crash Reporting API too.

@ddbeck ddbeck marked this pull request as draft April 3, 2026 18:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

feature definition Creating or defining new features or groups of features.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add feature for crash reporting storage API

2 participants