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

靜態方法：Buffer.allocUnsafeSlow(size)

參數

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

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

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

當使用 Buffer.allocUnsafe() 分配新的 Buffer 實例時，4 KiB 下的分配是從單個預分配的 Buffer 中分割出來的。這允許應用程序避免創建許多單獨分配的Buffer 實例的垃圾收集開銷。這種方法無需跟蹤和清理盡可能多的單個ArrayBuffer 對象，從而提高了性能和內存使用率。

但是，在開發人員可能需要在不確定的時間內從池中保留一小塊內存的情況下，使用 Buffer.allocUnsafeSlow() 創建 un-pooled Buffer 實例然後複製出相關位。

import { Buffer } from 'node:buffer';

// Need to keep around a few small chunks of memory.
const store = [];

socket.on('readable', () => {
  let data;
  while (null !== (data = readable.read())) {
    // Allocate for retained data.
    const sb = Buffer.allocUnsafeSlow(10);

    // Copy the data into the new allocation.
    data.copy(sb, 0, 0, 10);

    store.push(sb);
  }
});const { Buffer } = require('node:buffer');

// Need to keep around a few small chunks of memory.
const store = [];

socket.on('readable', () => {
  let data;
  while (null !== (data = readable.read())) {
    // Allocate for retained data.
    const sb = Buffer.allocUnsafeSlow(10);

    // Copy the data into the new allocation.
    data.copy(sb, 0, 0, 10);

    store.push(sb);
  }
});

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