KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

DataView: expliciete toegang tot binaire formaten

DataView leest en schrijft meerbytewaarden in een buffer met gekozen bytevolgorde en zonder uitlijningsvereiste.

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

Syntax

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

new DataView(buffer, byteOffset?, byteLength?) maakt een view op een bestaande ArrayBuffer of SharedArrayBuffer; bytes worden niet gekopieerd. Anders dan typed arrays is toegang niet beperkt tot één elementtype of uitgelijnde offsets. Methoden zoals getUint16, setFloat32 en getBigInt64 krijgen een byte-offset. Het optionele littleEndian is standaard false, zodat meerbytewaarden standaard big-endian gebruiken.

byteOffset en een expliciete byteLength doorlopen ToIndex. Een negatief resultaat, oneindigheid of bereik buiten de buffer werpt RangeError. Een toegang waarvan de volledige breedte niet in de view past werpt ook RangeError; een ongeldige receiver, losgekoppelde buffer of door verkleining buiten bereik geraakte view werpt TypeError. BigInt-methoden zoals setBigUint64 weigeren een gewone Number; geef bijvoorbeeld 1n.

Als byteLength bij een verkleinbare of vergrootbare ArrayBuffer ontbreekt, volgt de view het huidige buffereinde. Een expliciete byteLength maakt een view met vaste lengte die na verkleining buiten bereik kan raken. DataView stamt uit ECMAScript 2015; resizable ArrayBuffer en lengtevolgende views zijn beschikbaar vanaf ECMAScript 2024.

Het bereiklabel DataView.getUint16 duidt de instantiemethode aan die als view.getUint16(byteOffset, littleEndian?) wordt aangeroepen, niet een statische methode van de constructor DataView. Ze leest precies 2 bytes op elke uitlijning en geeft een geheel getal van 0 tot en met 65535. littleEndian met false of undefined kiest big-endian en true kiest little-endian; een leesactie voorbij het einde van de view werpt RangeError.

Voorbeelden

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

Resultaat

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

Bronnen