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。