ArrayBuffer.prototype.resize()

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 Lnge in Bytes, auf die der ArrayBuffer gendert werden soll.

Rckgabewert

Keiner (undefined).

Ausnahmen

TypeError

Wird ausgelst, wenn der ArrayBuffer getrennt ist oder nicht vernderbar ist.

RangeError

Wird ausgelst, wenn newLength grer ist als die maxByteLength des ArrayBuffer.

Beschreibung

Die resize()-Methode ndert die Gre eines ArrayBuffer auf die durch den Parameter newLength angegebene Gre, vorausgesetzt, der ArrayBuffer ist vernderbar und die neue Gre ist kleiner oder gleich der maxByteLength des ArrayBuffer. Neue Bytes werden auf 0 initialisiert.

Beachten Sie, dass Sie resize() verwenden knnen, um einen ArrayBuffer sowohl zu verkleinern als auch zu vergrern es ist zulssig, dass newLength kleiner als die aktuelle byteLength des ArrayBuffer ist.

Beispiele

Verwenden von resize()

In diesem Beispiel erstellen wir einen 8-Byte-Puffer, der auf eine maximale Lnge von 16 Bytes vernderbar ist. Dann prfen wir seine resizable-Eigenschaft und ndern die Gre, wenn resizable true zurckgibt:

const buffer = new ArrayBuffer(8, { maxByteLength: 16 });

if (buffer.resizable) {
  console.log("Buffer is resizable!");
  buffer.resize(12);
}

Spezifikationen

Browser-Kompatibilitt

Siehe auch

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