Window: atob() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

Window 介面的 atob() 方法解碼使用 Base64 編碼的資料字串。你可以使用 Window.btoa() 方法編碼和傳輸可能導致通訊問題的資料,然後傳輸它並使用 atob() 方法再次解碼資料。例如,你可以編碼、傳輸和解碼控制字元,例如 ASCII 值 0 到 31。

另外,也可以考慮使用 Uint8Array.fromBase64() 方法,它從 base64 編碼的字串建立一個 Uint8Array 物件。它會生成一個位元組陣列,比包含原始位元組的字串更容易處理。

語法

js
atob(encodedData)

引數

encodedData

一個 base64 編碼的字串,使用 Window.btoa() 生成的字母表。

返回值

一個包含從 encodedData 解碼的原始位元組的二進位制字串。JavaScript 中的字串以 UTF-16 編碼,這意味著每個字元的程式碼點必須小於 256,代表一個位元組的資料。

異常

InvalidCharacterError DOMException

如果 encodedData 不是有效的 base64,則丟擲。

示例

js
const encodedData = window.btoa("Hello, world"); // encode a string
const decodedData = window.atob(encodedData); // decode the string

有關更多示例,請參閱 Window.btoa() 方法。

規範

規範
HTML
# dom-atob-dev

瀏覽器相容性

另見