Repository: node
Issue: doc: `DOMException` missing from “Errors” API reference docs page
Labels: assert,doc,discuss,errors,abortcontroller

# 📗 API Reference Docs Problem

<!--

Thank you for wanting to make nodejs.org better!

This template is for issues with the Node.js API
reference documentation.

For problems with nodejs.org beyond the API
reference documentation, please open an issue
using the issue tracker for our site repository.

  https://github.com/nodejs/nodejs.org

For more general support, please open an issue
using the issue tracker for our help repository.

  https://github.com/nodejs/help

---

For the issue title, please enter a one-line
summary after “doc:” (preferably 50 characters
or less and no more than 72).

The “✍️” are placeholders signifying requests for
input. Replace them with your responses.

If you are unsure of something, do your best.

-->

<!-- The output of “node --version”. -->

- **Version**: [v17.0.0](https://nodejs.org/en/blog/release/v17.0.0/)

<!-- The output of “uname -a” (UNIX) or version
and 32-bit or 64-bit (Windows). -->

- **Platform**: Linux 5.10.47-linuxkit x86_64 GNU/Linux

<!-- The name of affected core module. -->

- **Subsystem**: `errors`

## Location

_Section of the site where the content exists_

Affected URL(s):

- https://nodejs.org/api/globals.html#domexception
- https://nodejs.org/api/errors.html

## Description

_Concise explanation of the problem_

<!-- If applicable, include any screenshots that
may help solve the problem. -->

[`DOMException`](https://webidl.spec.whatwg.org/#idl-DOMException), which was [made globally available](https://github.com/nodejs/node/issues/39098) in v17.0.0, is not amongst the runtime errors listed in our [&ldquo;Errors&rdquo; API reference docs](https://nodejs.org/dist/latest-v17.x/docs/api/errors.html). 

It is, however, correctly listed on the [&ldquo;Globals&rdquo; page](https://nodejs.org/dist/latest-v17.x/docs/api/globals.html).

By referencing the original (&ldquo;Globals&rdquo;) location from a brand new section dedicated to `DOMException` on our &ldquo;Errors&rdquo; page, I am thinking that we may be able to have it listed on both pages similar to how we list `AssertionError` on both [`/api/errors.html`](https://nodejs.org/api/errors.html#class-assertionerror) and [`/api/assert.html`](https://nodejs.org/api/assert.html#class-assertassertionerror). Thoughts?

P.S. Unsure of how relevant this may be (perhaps wrt the potential misclassification of `AbortError` raised in #40692), but this seems worth mentioning in this issue&hellip;

Along w/ [`structuredClone`](https://nodejs.org/api/globals.html#structuredclonevalue-options) ([spec link](https://html.spec.whatwg.org/multipage/structured-data.html#structured-cloning)) &mdash; which was also made globally available in v17.0.0 &mdash; we appear to have added our first (?) couple of objects to be classified as [&ldquo;platform objects&rdquo;](https://webidl.spec.whatwg.org/#es-platform-objects) according to [Web IDL](https://webidl.spec.whatwg.org/) (at least that’s mine and @domenic’s current interpret of the spec, anyway). Perhaps it may be worth explicitly identifying them as such in our documentation?

Any additional information/suggestions would be appreciated. It seems like it could simply be a minor oversight unless I am mistaken.

/cc @aduh95 @targos @Trott @BridgeAR @addaleax @mcollina @benjamingr @jasnell (et al. who may have more context)

---

<!-- Use “[x]” to check the box below if you are
interested in contributing. -->

- [x] I would like to work on this issue and
      submit a pull request.