From 00110ac4f58c1508c9f1eff4a7ab91bdabd679aa Mon Sep 17 00:00:00 2001 From: "Dr.XYZ" Date: Mon, 6 Jan 2025 16:56:15 +0800 Subject: [PATCH 1/4] create --- files/zh-tw/glossary/base64/index.md | 64 ++++++++++++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 files/zh-tw/glossary/base64/index.md diff --git a/files/zh-tw/glossary/base64/index.md b/files/zh-tw/glossary/base64/index.md new file mode 100644 index 00000000000000..54c1bda4099083 --- /dev/null +++ b/files/zh-tw/glossary/base64/index.md @@ -0,0 +1,64 @@ +--- +title: Base64 +slug: Glossary/Base64 +l10n: + sourceCommit: 087a73e18e2818c1cc6b9955218c614c44e612a0 +--- + +{{GlossarySidebar}} + +**Base64** 是一組相似的[二進位到文字編碼](https://en.wikipedia.org/wiki/Binary-to-text_encoding)系統，透過將二進位資料轉換為底數為 64，使結果表示為 {{glossary("ASCII")}} 字串格式。_Base64_ 這個術語源自於一種特定的 [MIME 內容傳送編碼](https://en.wikipedia.org/wiki/MIME#Content-Transfer-Encoding)。 + +當「Base64」單獨用於指代特定的{{glossary("algorithm", "演算法")}}時，通常指的是 [RFC 4648](https://datatracker.ietf.org/doc/html/rfc4648) 第 4 節中描述的 Base64 版本，它使用以下字母表來表示基數為 64 的數字，並使用 `=` 作為填充字元： + +```plain +ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/ +``` + +一種常見的變體是「Base64 URL 安全編碼」，它省略了填充，並將 `+/` 替換為 `-_`，以避免在 {{glossary("URL")}} 路徑段或查詢參數中可能引起問題的字元。如果資料不會放置在路徑段或查詢參數中，例如 [data URLs](/zh-TW/docs/Web/URI/Schemes/data) 就沒有這些限制，因此可以使用標準的 Base64 編碼。 + +Base64 編碼系統常用於將二進位資料進行編碼，以便在只能處理 ASCII 文字（或某種超集但仍無法接受任意二進位資料）的媒體上儲存或傳輸。這可確保資料在傳輸過程中保持完整且未被修改。Base64 的常見應用包括： + +- 透過 [MIME](https://en.wikipedia.org/wiki/MIME) 發送電子郵件 +- 在 [XML](/zh-TW/docs/Web/XML) 中儲存複雜資料 +- 將二進位資料編碼後納入 [`data:` URL](/zh-TW/docs/Web/URI/Schemes/data) 中 + +## 編碼後的大小增長 + +每個 Base64 字元代表 6 個位元。因此，輸入字串或二進位檔案中的三個 8 位元位元組（3×8 位元 = 24 位元）可以由四個 6 位元的 Base64 字元（4×6 = 24 位元）表示。 + +這意味著 Base64 版本的字串或檔案通常會比原始來源大三分之一（確切的大小增長取決於多個因素，例如字串的絕對長度、其長度對 3 取餘數的結果，以及是否使用填充字元）。 + +## 最後一個區塊 + +Base64 字串可以分成 4 個字元為一組的區塊，最後一組可能少於 4 個字元。最後一組可以使用 `=` 字元進行填充，以確保其剛好為 4 個字元。若不考慮填充字元，最後一組可能是以下三種情況之一： + +- 2 個字元：編碼 12 位元，表示 1 個位元組（8 位元）的資料 +- 3 個字元：編碼 18 位元，表示 2 個位元組（16 位元）的資料 +- 4 個字元：編碼 24 位元，表示 3 個位元組（24 位元）的資料 + +在前兩種情況下，字元可能包含 4 個或 2 個額外的尾部位元，這些位元不代表任何資料。在這種情況下，[RFC 4648](https://datatracker.ietf.org/doc/html/rfc4648#section-3.5) 要求編碼器將這些位元設為零，解碼器則可以選擇在這些位元不是零時拋出錯誤。例如，如果編碼資料為單一位元組 `0b01010101`，則需要兩個字元 `0b010101`（`V`）和 `0b010000`（`Q`），其中第二個字元的 4 個尾部位元設為零。解碼 `VR==`（第二個字元表示 `0b010001`）在技術上仍然得到相同的位元組 `0b01010101`，但解碼器可能因尾部位元未設為零而拋出錯誤。 + +## JavaScript 支援 + +{{jsxref("Uint8Array")}} 類別提供 {{jsxref("Uint8Array.fromBase64()")}}、{{jsxref("Uint8Array.prototype.toBase64()")}} 和 {{jsxref("Uint8Array.prototype.setFromBase64()")}} 方法，用於 Base64 字串之間的轉換。 + +瀏覽器還提供兩個原生 JavaScript 函數，用於解碼和編碼 Base64 字串： + +- {{domxref("Window.btoa()")}}（也可在 {{domxref("WorkerGlobalScope.btoa()", "worker 中使用", "", "nocode")}} 中使用）：將二進位資料字串轉換為 Base64 編碼的 ASCII 字串（「btoa」應理解為「binary to ASCII」）。 +- {{domxref("Window.atob()")}}（也可在 {{domxref("WorkerGlobalScope.atob()", "worker 中使用", "", "nocode")}} 中使用）：將 Base64 編碼字串解碼為二進位字串（「atob」應理解為「ASCII to binary」）。 + +> [!NOTE] +> Base64 是一種二進位編碼而非文字編碼，但 `btoa` 和 `atob` 是在 Web 平台尚未支援二進位資料類型之前加入的。因此這兩個函數使用字串來表示二進位資料，並將每個字元的{{glossary("code point", "碼位")}}對應於每個位元組的數值。這導致一種常見的誤解，認為 `btoa` 可以用來編碼任意文字資料，例如創建包含文字或 HTML 文件的 Base64 `data:` URL。 +> +> 然而，碼位與位元組的對應僅在 `0x7f` 以內可靠。此外，超過 `0xff` 的字元代碼點將導致 `btoa` 出現錯誤，因為它超出了單一位元組的最大值。下一節將說明在編碼任意 Unicode 文字時如何解決此限制。 + +## 參見 + +- JavaScript API： + - {{domxref("Window.atob()")}}（也可在 {{domxref("WorkerGlobalScope.atob()", "worker 中使用", "", "nocode")}} 中使用） + - {{domxref("Window.btoa()")}}（也可在 {{domxref("WorkerGlobalScope.btoa()", "worker 中使用", "", "nocode")}} 中使用） + - {{jsxref("Uint8Array")}} +- [Data URLs](/zh-TW/docs/Web/URI/Schemes/data) +- [Base64](https://en.wikipedia.org/wiki/Base64)（維基百科） +- [RFC 4648](https://datatracker.ietf.org/doc/html/rfc4648) 中描述的 Base64 演算法 From 808bfe6f155ea4c0f7dd0d795792aabc059f087b Mon Sep 17 00:00:00 2001 From: "Dr.XYZ" Date: Mon, 6 Jan 2025 17:00:54 +0800 Subject: [PATCH 2/4] fix --- files/zh-tw/glossary/base64/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/files/zh-tw/glossary/base64/index.md b/files/zh-tw/glossary/base64/index.md index 54c1bda4099083..1cae8eb9936e22 100644 --- a/files/zh-tw/glossary/base64/index.md +++ b/files/zh-tw/glossary/base64/index.md @@ -7,7 +7,7 @@ l10n: {{GlossarySidebar}} -**Base64** 是一組相似的[二進位到文字編碼](https://en.wikipedia.org/wiki/Binary-to-text_encoding)系統，透過將二進位資料轉換為底數為 64，使結果表示為 {{glossary("ASCII")}} 字串格式。_Base64_ 這個術語源自於一種特定的 [MIME 內容傳送編碼](https://en.wikipedia.org/wiki/MIME#Content-Transfer-Encoding)。 +**Base64** 是一組相似的[二進位到文字編碼](https://zh.wikipedia.org/wiki/Binary-to-text_encoding)系統，透過將二進位資料轉換為底數為 64，使結果表示為 {{glossary("ASCII")}} 字串格式。_Base64_ 這個術語源自於一種特定的 [MIME 內容傳送編碼](https://zh.wikipedia.org/wiki/MIME#Content-Transfer-Encoding)。 當「Base64」單獨用於指代特定的{{glossary("algorithm", "演算法")}}時，通常指的是 [RFC 4648](https://datatracker.ietf.org/doc/html/rfc4648) 第 4 節中描述的 Base64 版本，它使用以下字母表來表示基數為 64 的數字，並使用 `=` 作為填充字元： @@ -19,7 +19,7 @@ ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/ Base64 編碼系統常用於將二進位資料進行編碼，以便在只能處理 ASCII 文字（或某種超集但仍無法接受任意二進位資料）的媒體上儲存或傳輸。這可確保資料在傳輸過程中保持完整且未被修改。Base64 的常見應用包括： -- 透過 [MIME](https://en.wikipedia.org/wiki/MIME) 發送電子郵件 +- 透過 [MIME](https://zh.wikipedia.org/wiki/MIME) 發送電子郵件 - 在 [XML](/zh-TW/docs/Web/XML) 中儲存複雜資料 - 將二進位資料編碼後納入 [`data:` URL](/zh-TW/docs/Web/URI/Schemes/data) 中 @@ -60,5 +60,5 @@ Base64 字串可以分成 4 個字元為一組的區塊，最後一組可能少 - {{domxref("Window.btoa()")}}（也可在 {{domxref("WorkerGlobalScope.btoa()", "worker 中使用", "", "nocode")}} 中使用） - {{jsxref("Uint8Array")}} - [Data URLs](/zh-TW/docs/Web/URI/Schemes/data) -- [Base64](https://en.wikipedia.org/wiki/Base64)（維基百科） +- [Base64](https://zh.wikipedia.org/wiki/Base64)（維基百科） - [RFC 4648](https://datatracker.ietf.org/doc/html/rfc4648) 中描述的 Base64 演算法 From 8c1b752db6d3de9a4cd42e343828c4adf784b940 Mon Sep 17 00:00:00 2001 From: "Dr.XYZ" Date: Tue, 7 Jan 2025 16:45:53 +0800 Subject: [PATCH 3/4] fix --- files/zh-tw/glossary/base64/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/files/zh-tw/glossary/base64/index.md b/files/zh-tw/glossary/base64/index.md index 1cae8eb9936e22..eb4922ead383b9 100644 --- a/files/zh-tw/glossary/base64/index.md +++ b/files/zh-tw/glossary/base64/index.md @@ -7,7 +7,7 @@ l10n: {{GlossarySidebar}} -**Base64** 是一組相似的[二進位到文字編碼](https://zh.wikipedia.org/wiki/Binary-to-text_encoding)系統，透過將二進位資料轉換為底數為 64，使結果表示為 {{glossary("ASCII")}} 字串格式。_Base64_ 這個術語源自於一種特定的 [MIME 內容傳送編碼](https://zh.wikipedia.org/wiki/MIME#Content-Transfer-Encoding)。 +**Base64** 是一組相似的[二進位到文字編碼](https://en.wikipedia.org/wiki/Binary-to-text_encoding)系統，透過將二進位資料轉換為底數為 64，使結果表示為 {{glossary("ASCII")}} 字串格式。_Base64_ 這個術語源自於一種特定的 [MIME 內容傳送編碼](https://zh.wikipedia.org/wiki/多用途互聯網郵件擴展#內容傳輸編碼)。 當「Base64」單獨用於指代特定的{{glossary("algorithm", "演算法")}}時，通常指的是 [RFC 4648](https://datatracker.ietf.org/doc/html/rfc4648) 第 4 節中描述的 Base64 版本，它使用以下字母表來表示基數為 64 的數字，並使用 `=` 作為填充字元： @@ -19,7 +19,7 @@ ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/ Base64 編碼系統常用於將二進位資料進行編碼，以便在只能處理 ASCII 文字（或某種超集但仍無法接受任意二進位資料）的媒體上儲存或傳輸。這可確保資料在傳輸過程中保持完整且未被修改。Base64 的常見應用包括： -- 透過 [MIME](https://zh.wikipedia.org/wiki/MIME) 發送電子郵件 +- 透過 [MIME](https://zh.wikipedia.org/wiki/多用途互聯網郵件擴展) 發送電子郵件 - 在 [XML](/zh-TW/docs/Web/XML) 中儲存複雜資料 - 將二進位資料編碼後納入 [`data:` URL](/zh-TW/docs/Web/URI/Schemes/data) 中 From a94f0d151687fd4633c43c680d7858f0e54b4de1 Mon Sep 17 00:00:00 2001 From: "Dr.XYZ" Date: Tue, 21 Jan 2025 08:54:30 +0800 Subject: [PATCH 4/4] Apply suggestions from code review Co-authored-by: A1lo --- files/zh-tw/glossary/base64/index.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/files/zh-tw/glossary/base64/index.md b/files/zh-tw/glossary/base64/index.md index eb4922ead383b9..e25e6cfeab3f3c 100644 --- a/files/zh-tw/glossary/base64/index.md +++ b/files/zh-tw/glossary/base64/index.md @@ -7,7 +7,7 @@ l10n: {{GlossarySidebar}} -**Base64** 是一組相似的[二進位到文字編碼](https://en.wikipedia.org/wiki/Binary-to-text_encoding)系統，透過將二進位資料轉換為底數為 64，使結果表示為 {{glossary("ASCII")}} 字串格式。_Base64_ 這個術語源自於一種特定的 [MIME 內容傳送編碼](https://zh.wikipedia.org/wiki/多用途互聯網郵件擴展#內容傳輸編碼)。 +**Base64** 是一組相似的[二進位到文字編碼](https://en.wikipedia.org/wiki/Binary-to-text_encoding)系統，透過將二進位資料轉換為底數為 64，使結果表示為 {{glossary("ASCII")}} 字串格式。_Base64_ 這個術語源自於一種特定的 [MIME 內容傳送編碼](https://zh.wikipedia.org/wiki/多用途互聯網郵件擴展#内容传输编码)。 當「Base64」單獨用於指代特定的{{glossary("algorithm", "演算法")}}時，通常指的是 [RFC 4648](https://datatracker.ietf.org/doc/html/rfc4648) 第 4 節中描述的 Base64 版本，它使用以下字母表來表示基數為 64 的數字，並使用 `=` 作為填充字元： @@ -15,7 +15,7 @@ l10n: ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/ ``` -一種常見的變體是「Base64 URL 安全編碼」，它省略了填充，並將 `+/` 替換為 `-_`，以避免在 {{glossary("URL")}} 路徑段或查詢參數中可能引起問題的字元。如果資料不會放置在路徑段或查詢參數中，例如 [data URLs](/zh-TW/docs/Web/URI/Schemes/data) 就沒有這些限制，因此可以使用標準的 Base64 編碼。 +一種常見的變體是「Base64 URL 安全編碼」，它省略了填充，並將 `+/` 替換為 `-_`，以避免在 {{glossary("URL")}} 路徑段或查詢參數中可能引起問題的字元。如果資料不會放置在路徑段或查詢參數中，例如 [data URL](/zh-TW/docs/Web/URI/Schemes/data) 就沒有這些限制，因此可以使用標準的 Base64 編碼。 Base64 編碼系統常用於將二進位資料進行編碼，以便在只能處理 ASCII 文字（或某種超集但仍無法接受任意二進位資料）的媒體上儲存或傳輸。這可確保資料在傳輸過程中保持完整且未被修改。Base64 的常見應用包括： @@ -29,9 +29,9 @@ Base64 編碼系統常用於將二進位資料進行編碼，以便在只能處 這意味著 Base64 版本的字串或檔案通常會比原始來源大三分之一（確切的大小增長取決於多個因素，例如字串的絕對長度、其長度對 3 取餘數的結果，以及是否使用填充字元）。 -## 最後一個區塊 +## 最後一個分塊 -Base64 字串可以分成 4 個字元為一組的區塊，最後一組可能少於 4 個字元。最後一組可以使用 `=` 字元進行填充，以確保其剛好為 4 個字元。若不考慮填充字元，最後一組可能是以下三種情況之一： +Base64 字串可以分成 4 個字元為一組的分塊，最後一組可能少於 4 個字元。最後一組可以使用 `=` 字元進行填充，以確保其剛好為 4 個字元。若不考慮填充字元，最後一組可能是以下三種情況之一： - 2 個字元：編碼 12 位元，表示 1 個位元組（8 位元）的資料 - 3 個字元：編碼 18 位元，表示 2 個位元組（16 位元）的資料 @@ -45,8 +45,8 @@ Base64 字串可以分成 4 個字元為一組的區塊，最後一組可能少 瀏覽器還提供兩個原生 JavaScript 函數，用於解碼和編碼 Base64 字串： -- {{domxref("Window.btoa()")}}（也可在 {{domxref("WorkerGlobalScope.btoa()", "worker 中使用", "", "nocode")}} 中使用）：將二進位資料字串轉換為 Base64 編碼的 ASCII 字串（「btoa」應理解為「binary to ASCII」）。 -- {{domxref("Window.atob()")}}（也可在 {{domxref("WorkerGlobalScope.atob()", "worker 中使用", "", "nocode")}} 中使用）：將 Base64 編碼字串解碼為二進位字串（「atob」應理解為「ASCII to binary」）。 +- {{domxref("Window.btoa()")}}（也可在 {{domxref("WorkerGlobalScope.btoa()", "worker 中使用", "", "nocode")}}）：將二進位資料字串轉換為 Base64 編碼的 ASCII 字串（「btoa」應理解為「binary to ASCII」）。 +- {{domxref("Window.atob()")}}（也可在 {{domxref("WorkerGlobalScope.atob()", "worker 中使用", "", "nocode")}}）：將 Base64 編碼字串解碼為二進位字串（「atob」應理解為「ASCII to binary」）。 > [!NOTE] > Base64 是一種二進位編碼而非文字編碼，但 `btoa` 和 `atob` 是在 Web 平台尚未支援二進位資料類型之前加入的。因此這兩個函數使用字串來表示二進位資料，並將每個字元的{{glossary("code point", "碼位")}}對應於每個位元組的數值。這導致一種常見的誤解，認為 `btoa` 可以用來編碼任意文字資料，例如創建包含文字或 HTML 文件的 Base64 `data:` URL。 @@ -56,8 +56,8 @@ Base64 字串可以分成 4 個字元為一組的區塊，最後一組可能少 ## 參見 - JavaScript API： - - {{domxref("Window.atob()")}}（也可在 {{domxref("WorkerGlobalScope.atob()", "worker 中使用", "", "nocode")}} 中使用） - - {{domxref("Window.btoa()")}}（也可在 {{domxref("WorkerGlobalScope.btoa()", "worker 中使用", "", "nocode")}} 中使用） + - {{domxref("Window.atob()")}}（也可在 {{domxref("WorkerGlobalScope.atob()", "worker 中使用", "", "nocode")}}） + - {{domxref("Window.btoa()")}}（也可在 {{domxref("WorkerGlobalScope.btoa()", "worker 中使用", "", "nocode")}}） - {{jsxref("Uint8Array")}} - [Data URLs](/zh-TW/docs/Web/URI/Schemes/data) - [Base64](https://zh.wikipedia.org/wiki/Base64)（維基百科）