WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

DataView: expliziter Zugriff auf Binärformate

DataView liest und schreibt mehrbyteige Werte in einem Puffer mit gewählter Byteordnung und ohne Ausrichtungsanforderung.

Version: 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?) erzeugt eine Ansicht auf einen vorhandenen ArrayBuffer oder SharedArrayBuffer; Bytes werden nicht kopiert. Anders als Typed Arrays ist der Zugriff weder auf einen Elementtyp noch auf ausgerichtete Offsets beschränkt. Methoden wie getUint16, setFloat32 und getBigInt64 erhalten einen Byte-Offset. Das optionale littleEndian ist standardmäßig false, daher nutzen mehrbyteige Werte zunächst Big-Endian.

byteOffset und ein explizites byteLength durchlaufen ToIndex. Ein negatives Ergebnis, Unendlichkeit oder ein Bereich außerhalb des Puffers löst RangeError aus. Passt die volle Breite eines Zugriffs nicht in die Ansicht, entsteht ebenfalls RangeError; ungültiger Receiver, abgelöster Puffer oder eine durch Größenänderung außerhalb liegende Ansicht erzeugt TypeError. BigInt-Methoden wie setBigUint64 lehnen einen gewöhnlichen Number ab; übergib etwa 1n.

Wird byteLength bei einem vergrößerbaren ArrayBuffer weggelassen, verfolgt die Ansicht das aktuelle Pufferende. Ein explizites byteLength erzeugt eine Ansicht fester Länge, die nach Verkleinerung außerhalb liegen kann. DataView stammt aus ECMAScript 2015; vergrößerbare ArrayBuffer und längenverfolgende Ansichten gibt es ab ECMAScript 2024.

Die Bereichsbezeichnung DataView.getUint16 meint die Instanzmethode, die als view.getUint16(byteOffset, littleEndian?) aufgerufen wird, nicht eine statische Methode des Konstruktors DataView. Sie liest genau 2 Bytes bei beliebiger Ausrichtung und liefert eine ganze Zahl von 0 bis 65535. littleEndian mit false oder undefined wählt Big-Endian, true wählt Little-Endian; reicht der Lesezugriff über die Ansicht hinaus, entsteht RangeError.

Beispiele

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

Ergebnis

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

Quellen