SharedArrayBuffer.prototype.grow()

newLength

Die neue Länge, in Bytes, auf die der SharedArrayBuffer erweitert werden soll.

Keiner (undefined).

TypeError

Wird ausgelöst, wenn der SharedArrayBuffer nicht erweiterbar ist.

RangeError

Wird ausgelöst, wenn newLength größer ist als die maxByteLength des SharedArrayBuffer oder kleiner als die byteLength.

Die grow() Methode erweitert einen SharedArrayBuffer auf die Größe, die durch den Parameter newLength angegeben wird, vorausgesetzt, der SharedArrayBuffer ist erweiterbar und die neue Größe ist kleiner oder gleich der maxByteLength des SharedArrayBuffer. Neue Bytes werden auf 0 initialisiert.

In diesem Beispiel erstellen wir einen 8-Byte-Puffer, der auf eine maximale Länge von 16 Byte erweiterbar ist, und überprüfen dann seine growable Eigenschaft, um ihn zu erweitern, wenn growable true zurückgibt:

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