Constructeur ArrayBuffer()

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

Exemple interactif

Syntaxe

js
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 :

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

Spécifications

Specification
ECMAScript Language Specification
# sec-arraybuffer-constructor

Compatibilité des navigateurs

BCD tables only load in the browser

Notes de compatibilité

À 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.

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

Voir aussi