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);