Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

DataView: acesso explícito a formatos binários

DataView lê e escreve valores multibyte num buffer com ordem de bytes escolhida e sem requisito de alinhamento.

Versão: ECMAScript 2015 onward; resizable ArrayBuffer behavior from ECMAScript 2024; example target: Node.js 24.22.2

Sintaxe

new DataView(buffer); new DataView(buffer, byteOffset); new DataView(buffer, byteOffset, byteLength)

new DataView(buffer, byteOffset?, byteLength?) cria uma vista sobre um ArrayBuffer ou SharedArrayBuffer existente, sem copiar bytes. Ao contrário dos typed arrays, o acesso não fica limitado a um tipo de elemento nem a deslocamentos alinhados. Métodos como getUint16, setFloat32 e getBigInt64 recebem um deslocamento em bytes. O littleEndian opcional é false por omissão, por isso valores multibyte usam inicialmente big-endian.

byteOffset e um byteLength explícito passam por ToIndex. Resultado negativo, infinito ou intervalo fora do buffer lança RangeError. Um acesso cuja largura total não cabe na vista também lança RangeError; receiver inválido, buffer separado ou vista tornada fora de limites por redimensionamento lança TypeError. Métodos BigInt como setBigUint64 rejeitam um Number normal; passa, por exemplo, 1n.

Se byteLength for omitido num ArrayBuffer redimensionável, a vista acompanha o fim atual do buffer. Um byteLength explícito cria uma vista de comprimento fixo que pode ficar fora de limites após redução. DataView é do ECMAScript 2015; ArrayBuffer redimensionável e vistas que acompanham o comprimento existem desde ECMAScript 2024.

A etiqueta de âmbito DataView.getUint16 designa o método de instância chamado como view.getUint16(byteOffset, littleEndian?), não um método estático do construtor DataView. Lê exatamente 2 bytes com qualquer alinhamento e devolve um inteiro de 0 a 65535. littleEndian igual a false ou undefined escolhe big-endian e true escolhe little-endian; uma leitura para além da vista lança RangeError.

Exemplos

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

Fontes