SharedArrayBuffer.prototype.grow()

语法

grow(newLength)

参数

newLength

新的长度，以字节为单位，SharedArrayBuffer 调整后的大小。

返回值

无（undefined）。

异常

TypeError

如果当前的 SharedArrayBuffer 不可增大，则抛出该异常。

RangeError

如果 newLength 大于当前 SharedArrayBuffer 的 maxByteLength 或小于 byteLength，则抛出该异常。

描述

grow() 方将 SharedArrayBuffer 增大到 newLength 参数指定的大小，前提是 SharedArrayBuffer 是可增大的，并且新的大小小于等于当前 SharedArrayBuffer 的 maxByteLength。新字节被初始化为 0。

示例

使用 grow()

在这个示例中，我们创建一个 8 字节缓冲区，该缓冲区可调整大小到的最大长度是 16 字节，然后检查其 growable 属性，如果 growable 返回 true，则将其增大：

const buffer = new SharedArrayBuffer(8, { maxByteLength: 16 });

if (buffer.growable) {
  console.log("SAB 是可增大的！");
  buffer.grow(12);
}

规范

浏览器兼容性

参见

• SharedArrayBuffer
• SharedArrayBuffer.prototype.growable
• SharedArrayBuffer.prototype.maxByteLength