CKTIS / JavaScript
ArrayBuffer : tampon d’octets bruts
ArrayBuffer réserve une mémoire d’octets initialisée à zéro, accessible par typed array ou DataView et éventuellement redimensionnable.
Version : ECMAScript 2024 onward for resizable and transferable ArrayBuffer; example target: Node.js 24.22.2
Syntaxe
new ArrayBuffer(byteLength[, { maxByteLength }])new ArrayBuffer(byteLength, options?) crée un bloc mémoire rempli de zéros. ArrayBuffer n’expose pas lui-même des octets indexés ; lecture et écriture nécessitent une vue comme Uint8Array ou DataView. byteLength passe par ToIndex : une partie fractionnaire finie est tronquée vers zéro, NaN et undefined deviennent 0, et même -0.5 devient -0, donc une longueur de 0. Appeler le constructeur sans new lève TypeError.
options.maxByteLength demande un tampon redimensionnable si la limite n’est pas inférieure à la taille initiale. resize(newLength) conserve le préfixe commun, retranche des octets lors de la réduction et ajoute des zéros lors de l’agrandissement ; les vues suivant la longueur s’adaptent. Un tampon fixe ne peut être redimensionné. slice() copie une plage et un transfert peut détacher la source.
Seuls un résultat négatif après ToIntegerOrInfinity, +Infinity ou -Infinity, le dépassement de la plage numérique ou de la limite mémoire pratique de l’implémentation, ou un maximum inférieur à la taille initiale lèvent RangeError. Les opérations de données sur un tampon détaché et resize() sur un tampon fixe lèvent TypeError. Les erreurs de conversion se propagent. Le redimensionnement et les transferts ont été normalisés dans ECMAScript 2024.
L’étiquette de portée ArrayBuffer.byteLength désigne la propriété d’instance utilisée sous la forme buffer.byteLength, et non une propriété statique du constructeur ArrayBuffer. Cet accesseur en lecture seule renvoie le nombre actuel d’octets : le résultat change après resize() d’un tampon redimensionnable et vaut 0 après détachement. Il n’a pas de setter ; appliquer le getter à un receiver incompatible, notamment un SharedArrayBuffer, lève TypeError.
Exemples
const buffer = new ArrayBuffer(4, { maxByteLength: 8 });
const bytes = new Uint8Array(buffer);
bytes.set([10, 20, 30, 40]);
console.log(buffer.byteLength, buffer.maxByteLength, buffer.resizable);
buffer.resize(6);
console.log(buffer.byteLength, Array.from(new Uint8Array(buffer)).join(","));
const copy = buffer.slice(1, 4);
console.log(copy.byteLength, Array.from(new Uint8Array(copy)).join(","));
try { new ArrayBuffer(4).resize(2); } catch (error) { console.log(error instanceof TypeError); }Résultat
4 8 true 6 10,20,30,40,0,0 3 20,30,40 true