SharedArrayBuffer.prototype.grow()

Syntax

grow(newLength)

Parameter

newLength

Die neue Länge in Bytes, auf die der SharedArrayBuffer vergrößert werden soll.

Rückgabewert

Keiner (undefined).

Ausnahmen

TypeError

Wird ausgelöst, wenn der SharedArrayBuffer nicht vergrößert werden kann.

RangeError

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

Beschreibung

Die grow()-Methode vergrößert einen SharedArrayBuffer auf die Größe, die durch den newLength-Parameter angegeben ist, vorausgesetzt, dass der SharedArrayBuffer vergrößerbar ist und die neue Größe kleiner oder gleich der maxByteLength des SharedArrayBuffer ist. Neue Bytes werden auf 0 gesetzt.

Beispiele

Verwendung von grow()

In diesem Beispiel erstellen wir einen 8-Byte-Puffer, der auf eine maximale Länge von 16 Bytes vergrößerbar ist, überprüfen dann seine growable-Eigenschaft und vergrößern ihn, wenn growable true zurückgibt:

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

if (buffer.growable) {
  console.log("SAB is growable!");
  buffer.grow(12);
}

Spezifikationen

Browser-Kompatibilität

Siehe auch

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