Document Firefox Crash Reporting API Nightly support#44327
Document Firefox Crash Reporting API Nightly support#44327KirtiRamchandani wants to merge 2 commits into
Conversation
|
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:
External URLs (2)URL:
URL:
(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 |
| | Developer Edition | - | - | | ||
| | Beta | - | - | | ||
| | Release | - | - | |
There was a problem hiding this comment.
Can you make an update like this and prettier. Nightly means it is in all releases, but only enabled by default in nightly.
| | 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 |
There was a problem hiding this comment.
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. |
There was a problem hiding this comment.
| 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. |
| - **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)). |
There was a problem hiding this comment.
We indicate nightly like this.
| - **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)). |
There was a problem hiding this comment.
@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.
|
Thanks for the review. I pushed 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. |
Problem
Firefox 152 enables the Crash Reporting API in Nightly builds, but the MDN pages did not yet mention the Firefox preview and the
CrashReportpage pointed at a non-existent BCD key.Root cause
The Gecko change enables
dom.reporting.crash.enabledfor Nightly builds. TheCrashReportpage should use the existing BCD key that represents delivery ofcrashreports through theReporting-Endpointsdefault endpoint, while the newCrashReportContext/Window.crashReportsupport is tracked in a companion BCD update.Solution
dom.reporting.crash.enabled.CrashReportpage athttp.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.mdnpx --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.mdgit diff --checkRelated
Related docs work #44297
Companion BCD update: mdn/browser-compat-data#29782
Firefox bug: https://bugzil.la/2036160