SharedArrayBuffer.prototype.grow()
Baseline 2024Newly 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
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 diemaxByteLength
desSharedArrayBuffer
oder kleiner als diebyteLength
.
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
Specification |
---|
ECMAScript® 2026 Language Specification # sec-sharedarraybuffer.prototype.grow |