SharedArrayBuffer.prototype.grow()

语法

grow(newLength)

参数

newLength

要将 SharedArrayBuffer 调整到的新长度（以字节为单位）。

返回值

无（undefined）。

异常

TypeError

如果 SharedArrayBuffer 不可增长，则抛出此异常。

RangeError

如果 newLength 大于 SharedArrayBuffer 的 maxByteLength，或者小于 SharedArrayBuffer 的 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 is growable!");
  buffer.grow(12);
}

规范

浏览器兼容性

另见

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