CKTIS / JavaScript
DataView: acceso explícito a formatos binarios
DataView lee y escribe valores multibyte en un búfer con el orden de bytes elegido y sin requisito de alineación.
Versión: ECMAScript 2015 onward; resizable ArrayBuffer behavior from ECMAScript 2024; example target: Node.js 24.22.2
Sintaxis
new DataView(buffer); new DataView(buffer, byteOffset); new DataView(buffer, byteOffset, byteLength)new DataView(buffer, byteOffset?, byteLength?) crea una vista sobre un ArrayBuffer o SharedArrayBuffer existente, sin copiar bytes. A diferencia de los typed arrays, el acceso no se limita a un tipo de elemento ni a desplazamientos alineados. Métodos como getUint16, setFloat32 y getBigInt64 reciben un desplazamiento en bytes. El littleEndian opcional vale false por defecto, así que los valores multibyte usan inicialmente orden big-endian.
byteOffset y un byteLength explícito pasan por ToIndex. Un resultado negativo, infinito o un rango fuera del búfer lanza RangeError. Un acceso cuyo ancho completo no cabe en la vista también lanza RangeError; un receptor inválido, búfer separado o vista que queda fuera de rango al redimensionar lanza TypeError. Los métodos BigInt como setBigUint64 rechazan un Number normal; usa un valor como 1n.
Si se omite byteLength para un ArrayBuffer redimensionable, la vista sigue el final actual del búfer. Un byteLength explícito crea una vista de longitud fija que puede quedar fuera de rango al reducirse el búfer. DataView es de ECMAScript 2015; ArrayBuffer redimensionable y las vistas con seguimiento de longitud están disponibles desde ECMAScript 2024.
La etiqueta de alcance DataView.getUint16 designa el método de instancia llamado como view.getUint16(byteOffset, littleEndian?), no un método estático del constructor DataView. Lee exactamente 2 bytes con cualquier alineación y devuelve un entero de 0 a 65535. Un littleEndian igual a false o undefined elige big-endian y true elige little-endian; una lectura que sobrepasa la vista lanza RangeError.
Ejemplos
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); }Resultado
18,52,52,18,0,0,192,63 1234 1234 1.5 1 true