Skip to content

fix(api): use jsxref instead of domxref for JavaScript references - #45552

Open
caugner wants to merge 4 commits into
mainfrom
replace-domxref-with-jsxref-en-us
Open

fix(api): use jsxref instead of domxref for JavaScript references#45552
caugner wants to merge 4 commits into
mainfrom
replace-domxref-with-jsxref-en-us

Conversation

@caugner

@caugner caugner commented Sep 7, 2026

Copy link
Copy Markdown
Collaborator

Description

Use jsxref instead of domxref for JavaScript references in Web API pages, with one commit per replaced argument:

domxref jsxref Occurrences
ArrayBufferView TypedArray 1
Float32Array Float32Array 2
Promise Promise 1
Uint32Array Uint32Array 2

Motivation

Ensure these references link to their JavaScript reference pages directly. The Web/API URLs they used either redirect there or do not exist at all.

Additional details

Renamed arguments also update the rendered link text: ArrayBufferView becomes TypedArray.

Related issues and pull requests

Part of mdn/fred#1462.

…ay")`

`Web/API/ArrayBufferView` redirects to the JavaScript `TypedArray` reference
page, which the `jsxref` macro links to directly.

`ArrayBufferView` is a Web IDL typedef for the JavaScript typed array types.
…y")`

`Web/API/Float32Array` redirects to the JavaScript `Float32Array` reference
page, which the `jsxref` macro links to directly.
`Web/API/Uint32Array` redirects to the JavaScript `Uint32Array` reference
page, which the `jsxref` macro links to directly.
`Web/API/Promise` redirects to the JavaScript `Promise` reference
page, which the `jsxref` macro links to directly.
@github-actions github-actions Bot added Content:WebAPI Web API docs size/s [PR only] 6-50 LoC changed labels Sep 7, 2026
- Audio:
- {{domxref("AudioBuffer")}}
- {{domxref("ArrayBufferView")}}
- {{jsxref("TypedArray")}}

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

ArrayBufferView redirects to TypedArray, this is why.

@Josh-Cena Josh-Cena Sep 7, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

See #26044; you are missing DataView

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Maybe neither is correct? From https://webmachinelearning.github.io/prompt-api/#typedefdef-languagemodelmessagevalue it sounds like neither ArrayBufferView/TypedArray/DataView is supported.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

In doubt, we can also revert this line.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

In the worst case we can keep this as-is, but at least the spec's usage of ArrayBufferView is always translated to "DataView or TypedArray".

@caugner
caugner marked this pull request as ready for review September 7, 2026 16:50
@caugner
caugner requested a review from a team as a code owner September 7, 2026 16:50
@caugner
caugner requested review from sideshowbarker and removed request for a team September 7, 2026 16:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

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