ArrayBuffer.prototype.resize()
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 resize()-Methode von ArrayBuffer-Instanzen ändert die Größe des ArrayBuffer auf die angegebene Größe in Bytes.
Probieren Sie es aus
const buffer = new ArrayBuffer(8, { maxByteLength: 16 });
console.log(buffer.byteLength);
// Expected output: 8
buffer.resize(12);
console.log(buffer.byteLength);
// Expected output: 12
Syntax
resize(newLength)
Parameter
newLength-
Die neue Länge in Bytes, auf die der
ArrayBuffergeändert werden soll.
Rückgabewert
Keiner (undefined).
Ausnahmen
TypeError-
Wird ausgelöst, wenn der
ArrayBuffergetrennt oder nicht änderbar ist. RangeError-
Wird ausgelöst, wenn
newLengthgrößer ist als diemaxByteLengthdesArrayBuffer.
Beschreibung
Die resize()-Methode ändert die Größe eines ArrayBuffer auf die durch den Parameter newLength angegebene Größe, vorausgesetzt, dass der ArrayBuffer änderbar ist und die neue Größe kleiner oder gleich der maxByteLength des ArrayBuffer ist. Neue Bytes werden auf 0 initialisiert.
Beachten Sie, dass Sie resize() sowohl zum Verkleinern als auch zum Vergrößern eines ArrayBuffer verwenden können – es ist zulässig, dass newLength kleiner als das aktuelle byteLength des ArrayBuffer ist.
Beispiele
Verwendung von resize()
In diesem Beispiel erstellen wir einen 8-Byte-Puffer, der auf eine maximale Länge von 16 Bytes anpassbar ist, überprüfen dann seine resizable-Eigenschaft und ändern die Größe, wenn resizable true zurückgibt:
const buffer = new ArrayBuffer(8, { maxByteLength: 16 });
if (buffer.resizable) {
console.log("Buffer is resizable!");
buffer.resize(12);
}
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-arraybuffer.prototype.resize |