Node.js - Buffer.allocUnsafe() 方法

NodeJS 的 Buffer.allocUnsafe() 方法用於建立指定大小的新緩衝區。如果給定的大小大於 buffer.constants.MAX_LENGTH 或小於 0，則會丟擲型別為 ERR_INVALID_ARG_VALUE 的錯誤。如果給定的大小不是數字，則會丟擲 TypeError。

使用 buffer.allocUnsafe() 建立的緩衝區，分配的記憶體未初始化，其內容未知，即可能包含舊緩衝區的內容。也有可能包含敏感資料。出於安全考慮，最好使用 Buffer.alloc()。可以使用 Buffer.fill() 方法消除緩衝區中的舊資料。

語法

以下是 NodeJS Buffer.allocUnsafe() 方法 的語法：

Buffer.allocUnsafe(size)

引數

此方法接受一個引數。下面解釋了該引數。

• size - 此引數為整數值，表示要建立的緩衝區的長度。

返回值

Buffer.allocUnsafe() 方法將返回一個指定大小的新緩衝區。

示例

此示例將使用 NodeJS Buffer.allocUnsafe() 方法建立一個緩衝區：

const buf = Buffer.allocUnsafe(5);
console.log(buf);

輸出

緩衝區的大小為 5。執行上述程式將生成以下輸出：

<Buffer ff ff ff ff 39>

示例

此示例將使用 Buffer.allocUnsafe() 方法建立一個緩衝區，並使用 Buffer.fill() 方法填充緩衝區的值。

const buf = Buffer.allocUnsafe(5);
buf.fill('a')
console.log(buf);

輸出

緩衝區的大小為 5，我們已將緩衝區的內容填充為值：a。執行上述程式將生成以下輸出：

<Buffer 61 61 61 61 61>

示例

在此示例中，我們將看到如果使用的大小不是數字，則會丟擲錯誤。

const buf = Buffer.allocUnsafe('5');
buf.fill('a')
console.log(buf);

輸出

由於使用的大小為字串，因此這是一個無效的值，因為大小必須為整數值。當您執行上述程式時，它將丟擲如下所示的錯誤。執行上述程式將生成以下輸出：

TypeError [ERR_INVALID_ARG_TYPE]: The "size" argument must be of type number. Received type string
   at Function.allocUnsafe (buffer.js:284:3)
   at Object.<anonymous> (C:\nodejsProject\src\testbuffer.js:1:20)
   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