Skip to content

Document Firefox Crash Reporting API Nightly support#44327

Open
KirtiRamchandani wants to merge 2 commits into
mdn:mainfrom
KirtiRamchandani:docs/crash-reporting-firefox152
Open

Document Firefox Crash Reporting API Nightly support#44327
KirtiRamchandani wants to merge 2 commits into
mdn:mainfrom
KirtiRamchandani:docs/crash-reporting-firefox152

Conversation

@KirtiRamchandani
Copy link
Copy Markdown
Contributor

@KirtiRamchandani KirtiRamchandani commented Jun 1, 2026

Problem

Firefox 152 enables the Crash Reporting API in Nightly builds, but the MDN pages did not yet mention the Firefox preview and the CrashReport page pointed at a non-existent BCD key.

Root cause

The Gecko change enables dom.reporting.crash.enabled for Nightly builds. The CrashReport page should use the existing BCD key that represents delivery of crash reports through the Reporting-Endpoints default endpoint, while the new CrashReportContext/Window.crashReport support is tracked in a companion BCD update.

Solution

  • Add Firefox 152 release notes for the Crash Reporting API Nightly preview.
  • Add an Experimental features entry for dom.reporting.crash.enabled.
  • Point the CrashReport page at http.headers.Reporting-Endpoints.default.receives_crash_type.

Tests

  • npx --yes prettier@3.8.3 --config C:\Users\kirti\Documents\PRs\mdn-content\.prettierrc.json --check C:\Users\kirti\Documents\PRs\mdn-content\files\en-us\web\api\crashreport\index.md C:\Users\kirti\Documents\PRs\mdn-content\files\en-us\mozilla\firefox\releases\152\index.md C:\Users\kirti\Documents\PRs\mdn-content\files\en-us\mozilla\firefox\experimental_features\index.md
  • npx --yes --package markdownlint-cli2@0.22.1 --package markdownlint-rule-search-replace@1.2.0 markdownlint-cli2 --config C:\Users\kirti\Documents\PRs\mdn-content\.markdownlint-cli2.jsonc C:\Users\kirti\Documents\PRs\mdn-content\files\en-us\web\api\crashreport\index.md C:\Users\kirti\Documents\PRs\mdn-content\files\en-us\mozilla\firefox\releases\152\index.md C:\Users\kirti\Documents\PRs\mdn-content\files\en-us\mozilla\firefox\experimental_features\index.md
  • git diff --check

Related

Related docs work #44297
Companion BCD update: mdn/browser-compat-data#29782
Firefox bug: https://bugzil.la/2036160

@KirtiRamchandani KirtiRamchandani requested review from a team as code owners June 1, 2026 16:42
@KirtiRamchandani KirtiRamchandani requested review from pepelsbey and removed request for a team June 1, 2026 16:42
@github-actions github-actions Bot added Content:WebAPI Web API docs Content:Firefox Content in the Mozilla/Firefox subtree size/s [PR only] 6-50 LoC changed labels Jun 1, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 1, 2026

Preview URLs (3 pages)

Flaws (1)

Note! 2 documents with no flaws that don't need to be listed. 🎉

Found an unexpected or unresolvable flaw? Please report it here.

URL: /en-US/docs/Mozilla/Firefox/Releases/152
Title: Firefox 152 release notes for developers (Beta)
Flaw count: 1

  • macros:
    • Macro domxref produces link /en-US/docs/Web/API/SVGTextPathElement/side which doesn't resolve
External URLs (2)

URL: /en-US/docs/Mozilla/Firefox/Experimental_features
Title: Experimental features in Firefox


URL: /en-US/docs/Mozilla/Firefox/Releases/152
Title: Firefox 152 release notes for developers (Beta)

(comment last updated: 2026-06-02 05:47:01)

slug: Web/API/CrashReport
page-type: web-api-interface
browser-compat: api.ReportingObserver.ReportingObserver.options_parameter.types_property.crash
browser-compat: http.headers.Reporting-Endpoints.default.receives_crash_type
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Thanks!!!

Comment on lines +496 to +498
| Developer Edition | - | - |
| Beta | - | - |
| Release | - | - |
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Can you make an update like this and prettier. Nightly means it is in all releases, but only enabled by default in nightly.

Suggested change
| Developer Edition | - | - |
| Beta | - | - |
| Release | - | - |
| Developer Edition | 152 | No |
| Beta | 152 | No |
| Release | 152 | No |

- `layout.css.typed-om.enabled`
- : Set to `true` to enable.

### Crash Reporting API
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Please move up just below the API heading above. We use last-added ordering within a sub heading.

### Crash Reporting API

The [Crash Reporting API](/en-US/docs/Web/API/CrashReport) provides a way for sites to include diagnostic data in browser crash reports sent through the [Reporting API](/en-US/docs/Web/API/Reporting_API).
It exposes the {{domxref("Window.crashReport")}} property and the {{domxref("CrashReportContext")}} interface, which stores key-value data for the current top-level browsing context.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Suggested change
It exposes the {{domxref("Window.crashReport")}} property and the {{domxref("CrashReportContext")}} interface, which stores key-value data for the current top-level browsing context.
It exposes the {{domxref("Window.crashReport")}} property and the {{domxref("CrashReportContext")}} interface, which store key-value data for the current top-level browsing context.

Comment on lines +106 to +110
- **Crash Reporting API**: `dom.reporting.crash.enabled`

The [Crash Reporting API](/en-US/docs/Web/API/CrashReport) is now available in Nightly builds, where it is enabled by default.
This exposes {{domxref("Window.crashReport")}} and {{domxref("CrashReportContext")}}, allowing pages to store key-value diagnostic data that can be included in {{domxref("CrashReport")}} objects sent through the [Reporting API](/en-US/docs/Web/API/Reporting_API).
([Firefox bug 2036160](https://bugzil.la/2036160)).
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

We indicate nightly like this.

Suggested change
- **Crash Reporting API**: `dom.reporting.crash.enabled`
The [Crash Reporting API](/en-US/docs/Web/API/CrashReport) is now available in Nightly builds, where it is enabled by default.
This exposes {{domxref("Window.crashReport")}} and {{domxref("CrashReportContext")}}, allowing pages to store key-value diagnostic data that can be included in {{domxref("CrashReport")}} objects sent through the [Reporting API](/en-US/docs/Web/API/Reporting_API).
([Firefox bug 2036160](https://bugzil.la/2036160)).
- **Crash Reporting API** (Nightly): `dom.reporting.crash.enabled`
The [Crash Reporting API](/en-US/docs/Web/API/CrashReport) is now supported.
This exposes {{domxref("Window.crashReport")}} and {{domxref("CrashReportContext")}}, allowing pages to store key-value diagnostic data that can be included in {{domxref("CrashReport")}} objects sent through the [Reporting API](/en-US/docs/Web/API/Reporting_API).
([Firefox bug 2036160](https://bugzil.la/2036160)).

Copy link
Copy Markdown
Collaborator

@hamishwillee hamishwillee left a comment

Choose a reason for hiding this comment

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

@KirtiRamchandani Thanks! What made you decide to look at this issue?
These project issues are generally handled by the MDN team. I'm happy to take the fix because it is not far off what I would have done, but it isn't the best use of either of our efforts.
Usually best to start with issues labelled "good first issue".

Either way, we should hold off merging this just until this is answered https://bugzilla.mozilla.org/show_bug.cgi?id=2036160#c4 - i.e. there is something going on with the exposed interfaces.

@KirtiRamchandani
Copy link
Copy Markdown
Contributor Author

Thanks for the review. I pushed 8a2bcc9 with the requested ordering, table values, and Nightly wording. Prettier and markdownlint pass for the touched files.

I picked this up because it was a current Firefox 152/dev-doc-needed docs issue and looked scoped to release notes/experimental features. Understood that project issues are usually MDN-owned; I’ll focus on good-first or explicitly contributor-friendly issues going forward.

For the exposed-interface and endpoint details, I agree with holding merge until https://bugzilla.mozilla.org/show_bug.cgi?id=2036160#c4 is answered. I don’t want to infer runtime exposure from the pref/IDL alone.

@pepelsbey pepelsbey removed request for a team and pepelsbey June 4, 2026 16:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:Firefox Content in the Mozilla/Firefox subtree Content:WebAPI Web API docs size/s [PR only] 6-50 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants