SharedArrayBuffer.prototype.grow()

Baseline 2024
Newly available

Since July 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die grow()-Methode von SharedArrayBuffer-Instanzen vergrößert den SharedArrayBuffer auf die angegebene Größe in Bytes.

Syntax

js
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:

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

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

Spezifikationen

Specification
ECMAScript® 2026 Language Specification
# sec-sharedarraybuffer.prototype.grow

Browser-Kompatibilität

Siehe auch