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 July 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
Parameter
length-
Die Größe in Bytes des zu erstellenden Array-Buffers.
optionsOptional-
Ein Objekt, das die folgenden Eigenschaften enthalten kann:
maxByteLengthOptional-
Die maximale Größe in Bytes, auf die der Array-Buffer vergrößert werden kann.
Rückgabewert
Ein neues ArrayBuffer-Objekt der angegebenen Größe, wobei seine maxByteLength-Eigenschaft auf den angegebenen maxByteLength gesetzt ist, falls einer angegeben wurde. 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-Puffer mit einer Int32Array-Sicht, die sich auf den Puffer bezieht:
const buffer = new ArrayBuffer(8);
const view = new Int32Array(buffer);
Erstellen eines anpassbaren ArrayBuffers
In diesem Beispiel erstellen wir einen 8-Byte-Puffer, der auf eine maximale Länge von 16 Bytes vergrößert werden kann, und resize() ihn dann auf 12 Bytes:
const buffer = new ArrayBuffer(8, { maxByteLength: 16 });
buffer.resize(12);
Hinweis:
Es wird empfohlen, dass maxByteLength auf den kleinsten möglichen Wert für Ihren Anwendungsfall festgelegt wird. Es sollte niemals 1073741824 (1GB) überschreiten, um das Risiko von Speicherüberlauffehlern zu verringern.
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-arraybuffer-constructor |