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 erweitert 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 erweitert werden soll.

Rückgabewert

Keiner (undefined).

Ausnahmen

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.

Beschreibung

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.

Beispiele

Verwendung von grow()

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:

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