Buffer

参考:

概述

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 实例