Constructeur ArrayBuffer()
Baseline
Widely available
*
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.
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 |
Compatibilité des navigateurs
Chargement…
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.
const buffer = ArrayBuffer(10);
// TypeError: calling a builtin ArrayBuffer constructor
// without new is forbidden
const buffer = new ArrayBuffer(10);