Dieresize()-Methode vonArrayBuffer-Instanzen ändert die Größe desArrayBuffer auf die angegebene Größe in Bytes.

Probieren Sie es aus

const buffer = new ArrayBuffer(8, { maxByteLength: 16 });console.log(buffer.byteLength);// Expected output: 8buffer.resize(12);console.log(buffer.byteLength);// Expected output: 12

Syntax

resize(newLength)

Parameter

newLength

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

Rückgabewert

Keiner (undefined).

Ausnahmen

TypeError

Wird ausgelöst, wenn derArrayBuffer getrennt ist oder nicht veränderbar ist.

RangeError

Wird ausgelöst, wennnewLength größer ist als diemaxByteLength desArrayBuffer.

Beschreibung

Dieresize()-Methode ändert die Größe einesArrayBuffer auf die durch den ParameternewLength angegebene Größe, vorausgesetzt, derArrayBuffer istveränderbar und die neue Größe ist kleiner oder gleich dermaxByteLength desArrayBuffer. Neue Bytes werden auf 0 initialisiert.

Beachten Sie, dass Sieresize() verwenden können, um einenArrayBuffer sowohl zu verkleinern als auch zu vergrößern – es ist zulässig, dassnewLength kleiner als die aktuellebyteLength desArrayBuffer ist.

Beispiele

Verwenden von resize()

In diesem Beispiel erstellen wir einen 8-Byte-Puffer, der auf eine maximale Länge von 16 Bytes veränderbar ist. Dann prüfen wir seineresizable-Eigenschaft und ändern die Größe, wennresizabletrue zurückgibt:

const buffer = new ArrayBuffer(8, { maxByteLength: 16 });if (buffer.resizable) {  console.log("Buffer is resizable!");  buffer.resize(12);}

Spezifikationen

Browser-Kompatibilität

Siehe auch

• ArrayBuffer
• ArrayBuffer.prototype.resizable
• ArrayBuffer.prototype.maxByteLength