Skip to content

文字、字节和深拷贝 ​

文字、字节和深拷贝这一组全局 API 负责字符串和字节之间的转换,以及值的深拷贝。它们是 Web 标准里的同名 API,App 启动时就存在,不需要引入。

全局做什么
TextEncoder类。把字符串编码成 UTF-8 的字节
TextDecoder类。把 UTF-8 的字节解码成字符串
btoa()函数。把字节编码成 Base64 文本
atob()函数。把 Base64 文本解码成字节
structuredClone()函数。深拷贝一个值

两个类各有自己的页面。这一页是三个函数的页面。

怎么在文字、字节和 Base64 之间转换,怎么深拷贝,见指南在文字和字节之间转换。

注意:这一组 API 的结果标了「未在模拟器验证」的,来自标准(WHATWG Encoding、HTML)和验收用例里写的期望值。

函数 ​

btoa()

把「每个字符是一个字节」的字符串编码成 Base64。

atob()

把 Base64 解码成「每个字符是一个字节」的字符串。

structuredClone()

深拷贝一个值:对象、数组、Map、Set、Date、二进制数据,一层一层全部复制。

字符串和字节是两种东西 ​

网络请求的内容、文件、加密函数的输入都是字节(Uint8Array)。JS 的字符串不是字节,它是一串 16 位的码元。两者之间要转换:

转换用的编码是 UTF-8。一个字符占的字节数不固定,所以字节数和 text.length 一般不相等,见码元、字符和字节。只支持 UTF-8。

Base64 的两个函数处理的是字节,不是文字 ​

btoa() 的参数是字符串,但它把每个字符当成一个字节(0–255)。字符串里有汉字或表情时,btoa() 抛异常,name 是 InvalidCharacterError。

要把任意文字编码成 Base64,先用 TextEncoder 转成字节,写法见把文字编码成 Base64。

atob() 反过来:它返回的字符串里每个字符是一个字节。原文是文字时,还要用 TextDecoder 解码一次。

「每个字符是一个字节」的字符串 ​

btoa() 的参数和 atob() 的返回值都是这种字符串:每个字符的编码在 0 到 255 之间,代表一个字节。它不是给人看的文字,只是字节的另一种装法。

在它和 Uint8Array 之间转换:

js
const bytes = new Uint8Array([72, 105, 255]);
const binary = String.fromCharCode(...bytes);
const again = Uint8Array.from(binary, (c) => c.charCodeAt(0));
console.log(binary.length, again[2]);

结果:输出 3 255。未在模拟器验证。

注意:String.fromCharCode(...bytes) 把每个字节当成一个参数传进去。字节很多(几万个以上)时改用循环拼接,见把文字编码成 Base64里的写法。

哪些值不能深拷贝 ​

structuredClone() 复制的是数据。下面这些不是数据,传进去时抛异常,name 是 DataCloneError:

  • 函数、Symbol。
  • 原生对象:UIView、UIColor、UIImage、Blob,以及所有其他原生类的实例。
  • 结构体:CGRect、CGPoint 等。
  • 事件和事件源:Event、EventTarget、application。
  • URL、Headers、Request、Response 等运行时自己的类的实例。
  • WeakMap、WeakSet、WeakRef、Promise。

要拷贝的对象里只要有一处是上面这些,整个调用就抛异常,不会返回拷贝了一半的结果。

自己写的类的实例可以拷贝,但得到的是普通对象:字段都在,方法和原型没有了。

示例 ​

下面的代码把一段文字转成字节,再编码成 Base64,然后原路解回来,最后深拷贝一个对象。它不需要界面,直接写在 main.js 顶层就能运行。

js
// 1. 文字 → UTF-8 的字节
const encoder = new TextEncoder();
const bytes = encoder.encode('你好');
console.log(bytes.length, Array.from(bytes));

// 2. 字节 → Base64 文本。btoa 要的是「每个字符一个字节」的字符串
const base64 = btoa(String.fromCharCode(...bytes));
console.log(base64);

// 3. Base64 文本 → 字节 → 文字
const back = Uint8Array.from(atob(base64), (c) => c.charCodeAt(0));
console.log(new TextDecoder().decode(back));

// 4. 深拷贝:改拷贝出来的,原来的不变
const settings = { theme: 'dark', recent: [1, 2, 3], savedAt: new Date() };
const copy = structuredClone(settings);
copy.recent.push(4);
console.log(settings.recent.length, copy.recent.length, copy.savedAt instanceof Date);

结果(未在模拟器验证):控制台依次输出

  • 6 [228,189,160,229,165,189]:两个汉字各占 3 个字节。
  • 5L2g5aW9
  • 你好
  • 3 4 true:拷贝里的数组是另一个数组,Date 还是 Date。

和 Web 的差别 ​

三个函数的名字、参数、返回值和浏览器里的相同。不同的地方:

情况浏览器这里
btoa、atob、structuredClone 出错时抛出的对象DOMExceptionError,name 相同(InvalidCharacterError、DataCloneError)。按 err.name 判断的代码照常工作,按 instanceof DOMException 判断的不行,这里没有 DOMException 这个类
structuredClone(value, { transfer: [buffer] })把 buffer 转移给拷贝,原来的不能再用抛 DataCloneError。不写 transfer,buffer 会被复制一份
structuredClone(new SharedArrayBuffer(8))拷贝和原来的共用同一块内存抛 DataCloneError
structuredClone(new Blob(['x']))可以抛 DataCloneError

两个类的差别见 TextEncoder 和 TextDecoder。

参见 ​