Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

DataView: accesso esplicito ai formati binari

DataView legge e scrive valori multibyte in un buffer con ordine dei byte scelto e senza requisito di allineamento.

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

Sintassi

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

new DataView(buffer, byteOffset?, byteLength?) crea una vista su un ArrayBuffer o SharedArrayBuffer esistente senza copiare i byte. Diversamente dai typed array, l’accesso non è limitato a un tipo di elemento né a offset allineati. Metodi come getUint16, setFloat32 e getBigInt64 ricevono un offset in byte. Il littleEndian facoltativo è false per impostazione predefinita, quindi i valori multibyte usano inizialmente big-endian.

byteOffset e un byteLength esplicito passano per ToIndex. Un risultato negativo, infinito o un intervallo oltre il buffer genera RangeError. Anche un accesso la cui intera larghezza non entra nella vista genera RangeError; receiver non valido, buffer scollegato o vista resa fuori limite dal ridimensionamento genera TypeError. I metodi BigInt come setBigUint64 rifiutano un normale Number; passa per esempio 1n.

Se byteLength è omesso per un ArrayBuffer ridimensionabile, la vista segue la fine corrente del buffer. Un byteLength esplicito crea una vista di lunghezza fissa che può andare fuori limite dopo una riduzione. DataView risale a ECMAScript 2015; ArrayBuffer ridimensionabili e viste length-tracking sono disponibili da ECMAScript 2024.

L’etichetta di ambito DataView.getUint16 indica il metodo di istanza chiamato come view.getUint16(byteOffset, littleEndian?), non un metodo statico del costruttore DataView. Legge esattamente 2 byte con qualsiasi allineamento e restituisce un intero da 0 a 65535. littleEndian uguale a false o undefined sceglie big-endian, mentre true sceglie little-endian; una lettura oltre la fine della vista genera RangeError.

Esempi

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); }

Risultato

18,52,52,18,0,0,192,63
1234 1234 1.5
1
true

Fonti