Node.js Buffer.allocUnsafe(size)用法及代碼示例

靜態方法：Buffer.allocUnsafe(size)

參數

• size <integer> 新 Buffer 的所需長度。

分配 size 字節的新 Buffer。如果size大於 buffer.constants.MAX_LENGTH 或小於0，則拋出 ERR_INVALID_ARG_VALUE 。

以這種方式創建的Buffer 實例的底層內存未初始化。新創建的Buffer 的內容未知，可能包含敏感數據。改用 Buffer.alloc() 將 Buffer 實例初始化為零。

import { Buffer } from 'node:buffer';

const buf = Buffer.allocUnsafe(10);

console.log(buf);
// Prints (contents may vary): <Buffer a0 8b 28 3f 01 00 00 00 50 32>

buf.fill(0);

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

const buf = Buffer.allocUnsafe(10);

console.log(buf);
// Prints (contents may vary): <Buffer a0 8b 28 3f 01 00 00 00 50 32>

buf.fill(0);

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

如果 size 不是數字，則會拋出 TypeError。

Buffer 模塊預先分配一個大小為 Buffer.poolSize 的內部 Buffer 實例，用作快速分配使用 Buffer.allocUnsafe() 、 Buffer.from(array) 、 Buffer.concat() 創建的新 Buffer 實例的池，並且僅當 size 小於或等於 Buffer.poolSize >> 1( Buffer.poolSize 的下限除以 2)時才使用已棄用的 new Buffer(size) 構造函數。

使用此預先分配的內部內存池是調用 Buffer.alloc(size, fill) 與 Buffer.allocUnsafe(size).fill(fill) 之間的關鍵區別。具體來說，Buffer.alloc(size, fill) 永遠不會使用內部 Buffer 池，而如果 size 小於或等於 Buffer.poolSize 的一半，Buffer.allocUnsafe(size).fill(fill) 將使用內部 Buffer 池。差異很細微，但在應用程序需要 Buffer.allocUnsafe() 提供的額外性能時可能很重要。