ArrayBuffer()-Konstruktor
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
* Some parts of this feature may have varying levels of support.
Der ArrayBuffer()-Konstruktor erstellt ArrayBuffer-Objekte.
Probieren Sie es aus
// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(8);
console.log(buffer.byteLength);
// Expected output: 8
Syntax
new ArrayBuffer(length)
new ArrayBuffer(length, options)
Parameter
length-
Die Größe in Bytes des zu erstellenden ArrayBuffers.
optionsOptional-
Ein Objekt, das die folgenden Eigenschaften enthalten kann:
maxByteLengthOptional-
Die maximale Größe in Bytes, auf die der ArrayBuffer vergrößert werden kann.
Rückgabewert
Ein neues ArrayBuffer-Objekt der angegebenen Größe, dessen maxByteLength-Eigenschaft, falls angegeben, auf den angegebenen maxByteLength gesetzt ist. Sein Inhalt wird auf 0 initialisiert.
Ausnahmen
RangeError-
Wird in einem der folgenden Fälle ausgelöst:
lengthodermaxByteLengthist größer alsNumber.MAX_SAFE_INTEGER(≥ 253) oder negativ.lengthist größer alsmaxByteLength.
Beispiele
Erstellen eines ArrayBuffers
In diesem Beispiel erstellen wir einen 8-Byte-Pufferspeicher mit einer Int32Array-Sicht, die sich auf den Puffer bezieht:
const buffer = new ArrayBuffer(8);
const view = new Int32Array(buffer);
Erstellen eines vergrößerbaren ArrayBuffers
In diesem Beispiel erstellen wir einen 8-Byte-Pufferspeicher, der auf eine maximale Länge von 16 Bytes vergrößert werden kann, und ändern dann seine Größe auf 12 Bytes mit resize():
const buffer = new ArrayBuffer(8, { maxByteLength: 16 });
buffer.resize(12);
Hinweis:
Es wird empfohlen, maxByteLength auf den kleinstmöglichen Wert für Ihren Anwendungsfall festzulegen. Es sollte niemals 1073741824 (1GB) überschreiten, um das Risiko von Speicherausfällen zu verringern.
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-arraybuffer-constructor |