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