SharedArrayBuffer.prototype.grow()

Syntax

grow(newLength)

Parameter

newLength

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

Rückgabewert

Keiner (undefined).

Ausnahmen

TypeError

Wird ausgelöst, wenn der SharedArrayBuffer nicht vergrößerbar ist.

RangeError

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

Beschreibung

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

Beispiele

Beachten Sie, dass diese Beispiele nicht direkt von der Konsole oder einer beliebigen Webseite ausgeführt werden können, da SharedArrayBuffer nur definiert ist, wenn seine Sicherheitsanforderungen erfüllt sind.

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