Node.js Buffer.alloc(size[, fill[, encoding]])用法及代码示例

静态方法：Buffer.alloc(size[, fill[, encoding]])

参数

• size <integer> 新 Buffer 的所需长度。
• fill <string> | <Buffer> | <Uint8Array> | <integer> 用于预填充新 Buffer 的值。 默认： 0 。
• encoding <string> 如果fill 是一个字符串，这就是它的编码。 默认： 'utf8' 。

分配 size 字节的新 Buffer。如果 fill 是 undefined ，则 Buffer 将是 zero-filled。

import { Buffer } from 'node:buffer';

const buf = Buffer.alloc(5);

console.log(buf);
// Prints: <Buffer 00 00 00 00 00>const { Buffer } = require('node:buffer');

const buf = Buffer.alloc(5);

console.log(buf);
// Prints: <Buffer 00 00 00 00 00>

如果size大于 buffer.constants.MAX_LENGTH 或小于0，则抛出 ERR_INVALID_ARG_VALUE 。

如果指定了fill，则分配的Buffer 将通过调用 buf.fill(fill) 来初始化。

import { Buffer } from 'node:buffer';

const buf = Buffer.alloc(5, 'a');

console.log(buf);
// Prints: <Buffer 61 61 61 61 61>const { Buffer } = require('node:buffer');

const buf = Buffer.alloc(5, 'a');

console.log(buf);
// Prints: <Buffer 61 61 61 61 61>

如果同时指定 fill 和 encoding，则分配的 Buffer 将通过调用 buf.fill(fill, encoding) 来初始化。

import { Buffer } from 'node:buffer';

const buf = Buffer.alloc(11, 'aGVsbG8gd29ybGQ=', 'base64');

console.log(buf);
// Prints: <Buffer 68 65 6c 6c 6f 20 77 6f 72 6c 64>const { Buffer } = require('node:buffer');

const buf = Buffer.alloc(11, 'aGVsbG8gd29ybGQ=', 'base64');

console.log(buf);
// Prints: <Buffer 68 65 6c 6c 6f 20 77 6f 72 6c 64>

调用 Buffer.alloc() 可能比替代方法 Buffer.allocUnsafe() 慢得多，但可以确保新创建的 Buffer 实例内容永远不会包含来自先前分配的敏感数据，包括可能尚未为 Buffer 分配的数据。

如果 size 不是数字，则会抛出 TypeError。