atob() 全局函数
atob() 全局函数把 Base64 文本解码成字节。返回的是「每个字符是一个字节」的字符串。
语法
atob(data)参数
data
Base64 字符串。不是字符串的值先转成字符串。
- 里面的空格、制表符、换行、换页、回车先被去掉,可以出现在任何位置。
- 结尾的
=可以不写:atob('YQ')和atob('YQ==')结果相同。
返回值
「每个字符是一个字节」的字符串。原文是文字时,还要用 TextDecoder 解码一次。
异常
Error,name 是 InvalidCharacterError
下面几种情况抛出,报错原文都是 atob: the string is not correctly encoded Base64:
- 有 Base64 字母表之外的字符。
-和_(URL 里用的那种 Base64)也不认。 - 去掉空白之后长度除以 4 余 1,比如
'Y'。 =的位置或个数不对,比如'YQ='、'YQ==='、'Y=Q='。
TypeError
不给参数:atob: 1 argument required, but only 0 present
示例
js
const binary = atob('SGn/');
const bytes = Uint8Array.from(binary, (c) => c.charCodeAt(0));
console.log(binary.length, Array.from(bytes));
console.log(atob('aGVs bG8'));结果:输出 3 [72,105,255],然后 hello:空格被去掉,结尾的 = 可以不写。未在模拟器验证。
和 Web 的差别
浏览器抛出的是 DOMException,这里是 Error,name 相同(InvalidCharacterError)。按 err.name 判断的代码照常工作,按 instanceof DOMException 判断的不行,这里没有 DOMException 这个类。
参见
btoa():反过来编码- 把文字编码成 Base64:和文字之间的转换