CKTIS / JavaScript
DataView : accès explicite aux formats binaires
DataView lit et écrit des valeurs multioctets dans un tampon avec l’ordre des octets choisi et sans contrainte d’alignement.
Version : ECMAScript 2015 onward; resizable ArrayBuffer behavior from ECMAScript 2024; example target: Node.js 24.22.2
Syntaxe
new DataView(buffer); new DataView(buffer, byteOffset); new DataView(buffer, byteOffset, byteLength)new DataView(buffer, byteOffset?, byteLength?) crée une vue sur un ArrayBuffer ou SharedArrayBuffer existant, sans copier les octets. Contrairement aux typed arrays, l’accès n’est limité ni à un seul type d’élément ni aux décalages alignés. Des méthodes comme getUint16, setFloat32 et getBigInt64 reçoivent un décalage en octets. L’option littleEndian vaut false par défaut : les valeurs multioctets utilisent donc big-endian par défaut.
byteOffset et un byteLength explicite passent par ToIndex. Un résultat négatif, l’infini ou une plage hors tampon lève RangeError. Un accès dont toute la largeur ne tient pas dans la vue lève aussi RangeError ; un receiver invalide, un tampon détaché ou une vue devenue hors limites après redimensionnement lève TypeError. Les méthodes BigInt comme setBigUint64 refusent un Number ordinaire ; passez par exemple 1n.
Si byteLength est omis pour un ArrayBuffer redimensionnable, la vue suit la fin courante du tampon. Un byteLength explicite crée une vue de longueur fixe qui peut sortir des limites après réduction. DataView date d’ECMAScript 2015 ; les ArrayBuffer redimensionnables et vues à longueur suivie sont disponibles depuis ECMAScript 2024.
L’étiquette de portée DataView.getUint16 désigne la méthode d’instance appelée sous la forme view.getUint16(byteOffset, littleEndian?), et non une méthode statique du constructeur DataView. Elle lit exactement 2 octets sans contrainte d’alignement et renvoie un entier de 0 à 65535. littleEndian à false ou undefined choisit big-endian et true choisit little-endian ; une lecture dépassant la vue lève RangeError.
Exemples
const buffer = new ArrayBuffer(8);
const view = new DataView(buffer);
view.setUint16(0, 0x1234);
view.setUint16(2, 0x1234, true);
view.setFloat32(4, 1.5, true);
console.log(Array.from(new Uint8Array(buffer)).join(","));
console.log(view.getUint16(0).toString(16), view.getUint16(2, true).toString(16), view.getFloat32(4, true));
console.log(new DataView(buffer, 1, 3).byteOffset);
try { view.getUint32(6); } catch (error) { console.log(error instanceof RangeError); }Résultat
18,52,52,18,0,0,192,63 1234 1234 1.5 1 true