参考:
概述
JavaScript 语言自身只有字符串数据类型,没有二进制数据类型。因此在 Node.js 中,定义了一个 Buffer 类,该类用来创建一个专门存放二进制数据的缓存区。一个 Buffer 类似于一个整数数组,但它对应于 V8 堆内存之外的一块原始内存。
下面介绍一些常见的用法。完整的请参考官方文档。
编码与解码
将字符串转化为二进制数据的过程叫编码:
1
| const buf = Buffer.from('runoob', 'ascii');
|
将二进制数据转化为字符串的过程叫解码:
1
| console.log(buf.toString('hex')); // 输出 72756e6f6f62
|
Node.js 目前支持的字符编码包括:
- ascii:仅支持 7 位 ASCII 数据。如果设置去掉高位的话,这种编码是非常快的。
- utf8:多字节编码的 Unicode 字符。许多网页和其他文档格式都使用 UTF-8 。
- utf16le/ucs2:2 或 4 个字节,小字节序编码的 Unicode 字符。支持代理对(U+10000 至 U+10FFFF)。
- base64:Base64 编码。
- latin1/binary:一种把 Buffer 编码成一字节编码的字符串的方式。
- hex:将每个字节编码为两个十六进制字符。
创建 Buffer 类
Buffer 提供了以下 API 来创建 Buffer 类:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
| Buffer.alloc(size[, fill[, encoding]]);
// 返回一个指定大小的 Buffer 实例,如果没有设置 fill,则默认填满 0
Buffer.allocUnsafe(size);
// 返回一个指定大小的 Buffer 实例,但是它不会被初始化,所以它可能包含敏感的数据
Buffer.allocUnsafeSlow(size);
// 这个方法比调用 Buffer.alloc() 更快
// 但返回的 Buffer 实例可能包含旧数据,因此需要使用 fill() 或 write() 重写。
Buffer.from(array);
// 返回一个被 array 的值初始化的新的 Buffer 实例(传入的 array 的元素只能是数字,不然就会自动被 0 覆盖)
Buffer.from(arrayBuffer[, byteOffset[, length]]);
// 返回一个新建的与给定的 ArrayBuffer 共享同一内存的 Buffer。
Buffer.from(buffer);
// 复制传入的 Buffer 实例的数据,并返回一个新的 Buffer 实例
Buffer.from(string[, encoding]);
// 返回一个被 string 的值初始化的新的 Buffer 实例
|