Constructeur ArrayBuffer()

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.

Le constructeur ArrayBuffer() permet de créer des objets ArrayBuffer.

Exemple interactif

// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(8);

console.log(buffer.byteLength);
// Expected output: 8

Syntaxe

new ArrayBuffer(longueur);

Paramètres

longueur: La longueur, exprimée en octets, du tableau de mémoire tampon à créer.

Valeur de retour

Un nouvel objet ArrayBuffer de la taille indiquée et dont le contenu des éléments est fixé à 0.

Exceptions

Une exception RangeError est levée si longueur est supérieure ou égale à Number.MAX_SAFE_INTEGER (>= 2 ** 53) ou si elle est négative.

Exemples

Créer un objet `ArrayBuffer`

Dans cet exemple, on crée un tampon de 8 octets avec une vue Int32Array qui y fait référence :

const buffer = new ArrayBuffer(8);
const vue = new Int32Array(buffer);

Spécifications

Specification
ECMAScript® 2026 Language Specification # sec-arraybuffer-constructor

À partir d'ECMAScript 2015, le constructeur ArrayBuffer() doit être appelé avec l'opérateur new. Appeler le constructeur ArrayBuffer() comme une fonction, c'est-à-dire sans le mot-clé new, déclenchera une exception TypeError.

const buffer = ArrayBuffer(10);
// TypeError: calling a builtin ArrayBuffer constructor
// without new is forbidden

const buffer = new ArrayBuffer(10);