SharedArrayBuffer.prototype.grow()

newLength

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

Keiner (undefined).

TypeError

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

RangeError

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

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 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 Bytes vergrößert werden kann, und überprüfen dann seine growable Eigenschaft, um ihn zu vergrößern, 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