Reference for stage-3 arraybuffer-base64

[Josh-Cena]

This adds documentation for a new API: https://github.com/tc39/proposal-arraybuffer-base64. Based on tc39/proposal-arraybuffer-base64#51, it is in FF 133 and Safari TP 202.

cc @bakkot

[github-actions]

Preview URLs (12 pages)

• /en-US/docs/Glossary/Base64
• /en-US/docs/Web/API/Window/atob
• /en-US/docs/Web/API/Window/btoa
• /en-US/docs/Web/API/WorkerGlobalScope/atob
• /en-US/docs/Web/API/WorkerGlobalScope/btoa
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array/fromBase64
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array/fromHex
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array/setFromBase64
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array/setFromHex
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array/toBase64
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array/toHex
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array

External URLs (9)

URL: /en-US/docs/Glossary/Base64
Title: Base64

• https://datatracker.ietf.org/doc/html/rfc4648 (3 times) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array/toBase64
Title: Uint8Array.prototype.toBase64()

• https://github.com/tc39/proposal-arraybuffer-base64/blob/main/stream.mjs (1 time) (Note! This may be a new URL 👀)
• https://github.com/zloirock/core-js (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array/setFromBase64
Title: Uint8Array.prototype.setFromBase64()

• https://github.com/tc39/proposal-arraybuffer-base64/blob/main/stream.mjs (1 time) (Note! This may be a new URL 👀)
• https://github.com/zloirock/core-js (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array/setFromHex
Title: Uint8Array.setFromHex()

• https://github.com/zloirock/core-js (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array/toHex
Title: Uint8Array.prototype.toHex()

• https://github.com/zloirock/core-js (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array/fromHex
Title: Uint8Array.fromHex()

• https://github.com/zloirock/core-js (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array/fromBase64
Title: Uint8Array.fromBase64()

• https://github.com/zloirock/core-js (1 time) (Note! This may be a new URL 👀)

(comment last updated: 2024-11-04 22:24:34)

[bakkot]

Looks great! I left a few comments, which you can take or not.

[bakkot]

LGTM

[hamishwillee]

How about replace this whole section with

Base64, by design, expects binary data as its input. In terms of JavaScript strings, this means strings in which the code point of each character occupies only one byte. So if you pass a string into btoa() containing characters that occupy more than one byte, you will get an error, because this is not considered binary data.

For more information and workarounds see [LINK TO YOUR WINDOW info]

Or for consistency duplicate the content that you added in Window.btoa

[Josh-Cena]

I would prefer to not update non-JS pages in this PR... I only did:

1. Add links to JS in the glossary
2. Move stuff that are no longer pertinent thanks to the new JS API out of glossary
3. Remove references to glossary because the referenced section doesn't exist anymore, and readers would generally know to check Window.btoa when they are on WorkerGlobalScope.btoa anyway

[hamishwillee]

Disagree - mostly on 3. I've made the edit myself so I can merge this.

[hamishwillee]

Thanks for sorting this out @Josh-Cena. Very clear, as usual.