Node.js - Buffer.from() 方法



NodeJS Buffer.from() 方法将创建传递的 ArrayBuffer 副本,而不复制底层内存。当 TypedArray 实例的 .buffer 属性传递给 Buffer.from() 时,创建的缓冲区将与 TypedArray 共享相同的内存。

TypedArray 只不过是一个具有类似 view 的数组的对象。TypedArray 的示例为:new Int8Array()、new Uint16Array()。

语法

以下是Node.JS Buffer.from(arrayBuffer[, byteOffset[, length]]) 方法的语法 -


 Buffer.from(arrayBuffer[, byteOffset[, length]]) Buffer.from(buffer) Buffer.from(str[, encoding])

参数

此方法接受三个参数。下面将对此进行解释。

  • arrayBuffer − (必需) ArrayBuffer,SharedArrayBuffer,例如 TypedArray 的 .buffer 属性。
  • byteOffset − (可选) 偏移值。默认值为 0。
  • length − (可选) 要公开的字节。默认值为 arrayBuffer.length - byteOffset。
  • buffer − (必需) buffer 对象。
  • str − (必需) 字符串值。
  • encoding −(可选)要使用的编码。默认情况下,它是 utf-8。

返回值

方法 Buffer.from(arrayBuffer[, byteOffset[, length]]) 从 TypedArray 返回一个具有 .buffer 属性的新缓冲区。

在此示例中,将使用 NodeJS Int8Array() 并从中创建一个缓冲区。


const arr = new Int8Array(5);
arr[0] = 1;
arr[1] = 2;
arr[2] = 3;
const buf = Buffer.from(arr.buffer);
console.log(buf);

输出


	
<Buffer 01 02 03 00 00>

此示例将使用 Int8Array() 和 byteOffset 参数,并从中创建缓冲区。


const arr = new Int8Array(5);
arr[0] = 1;
arr[1] = 2;
arr[2] = 3;
const buf = Buffer.from(arr.buffer, 1);
console.log(buf);

输出

<Buffer 02 03 00 00>

此示例将使用 Int8Array() 和 byteOffset 以及 length 参数,并从中创建缓冲区。


const arr = new Int8Array(5);
arr[0] = 1;
arr[1] = 2;
arr[2] = 3;
const buf = Buffer.from(arr.buffer, 1, 3);
console.log(buf);

输出

<Buffer 02 03 00>

该示例将使用 buffer.from(buffer) 方法创建一个新的缓冲区。


const buffer1 = Buffer.from('Hello World');
const buffer2 = Buffer.from(buffer1);
console.log(buffer1.toString());
console.log(buffer2.toString());

输出

Hello World
Hello World

如果给定的输入不是缓冲区,则 Buffer.from() 方法将给出类型错误。


const buffer1 = 1;
const buffer2 = Buffer.from(buffer1);
console.log(buffer2);

输出

TypeError [ERR_INVALID_ARG_TYPE]: The "value" argument must not be of type number. Received type number
at Function.from (buffer.js:208:11)
at Object.<anonymous> (C:\nodejsProject\src\testbuffer.js:2:24)
at Module._compile (internal/modules/cjs/loader.js:816:30)
at Object.Module._extensions..js (internal/modules/cjs/loader.js:827:10)
at Module.load (internal/modules/cjs/loader.js:685:32)
at Function.Module._load (internal/modules/cjs/loader.js:620:12)
at Function.Module.runMain (internal/modules/cjs/loader.js:877:12)
at internal/main/run_main_module.js:21:11

该示例将使用 NodeJS buffer.from() 方法创建一个新的缓冲区。


const obj = new String('Welcome to Qikepu.com');
console.log(obj.valueOf());
const newbuffer = Buffer.from(obj);
console.log(newbuffer);

输出

Welcome to Qikepu.com
<Buffer 57 65 6c 63 6f 6d 65 20 74 6f 20 54 75 74 6f 72 69 61 6c 73 70 6f 69 6e 74 21>

该示例将使用 buffer.from() 方法创建一个新的缓冲区。


const object1 = {
	 	[Symbol.toPrimitive]() {
	 	 	 return 'testing buffer';
	 	}
}; 	
const newBuffer = Buffer.from(object1, 'utf8');
console.log(newBuffer);

输出

<Buffer 74 65 73 74 69 6e 67 20 62 75 66 66 65 72>

该示例将使用 buffer.from() 方法创建一个新的缓冲区,使用对象、编码和长度。


const object1 = {
	 	[Symbol.toPrimitive]() {
	 	 	 return 'testing buffer';
	 	}
}; 	
const newBuffer = Buffer.from(object1, 'utf-8', 10);
console.log(newBuffer);

输出

<Buffer 74 65 73 74 69 6e 67 20 62 75 66 66 65 72>