DataView()-Konstruktor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Der DataView()-Konstruktor erstellt DataView-Objekte.

Probieren Sie es aus

// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(16);

// Create a couple of views
const view1 = new DataView(buffer);
const view2 = new DataView(buffer, 12, 4); // From byte 12 for the next 4 bytes
view1.setInt8(12, 42); // Put 42 in slot 12

console.log(view2.getInt8(0));
// Expected output: 42

Syntax

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

Hinweis: DataView() kann nur mit new konstruiert werden. Der Versuch, es ohne new aufzurufen, führt zu einem TypeError.

Parameter

buffer: Ein vorhandener ArrayBuffer oder SharedArrayBuffer, der als Speicher für das neue DataView-Objekt dient.
byteOffset Optional: Der Offset in Bytes zum ersten Byte im obigen Buffer, auf das die neue Ansicht verweisen soll. Wenn nicht angegeben, beginnt die Ansicht des Buffers beim ersten Byte.
byteLength Optional: Die Anzahl der Elemente im Byte-Array. Wenn nicht angegeben, entspricht die Länge der Ansicht der Länge des Buffers.

Rückgabewert

Ein neues DataView-Objekt, das den angegebenen Datenpuffer darstellt.

Ausnahmen

RangeError: Wird ausgelöst, wenn die Werte der Parameter byteOffset oder byteLength dazu führen, dass die Ansicht über das Ende des Buffers hinausgeht. Mit anderen Worten, byteOffset + byteLength > buffer.byteLength.

Beispiele

Verwendung von DataView

const buffer = new ArrayBuffer(16);
const view = new DataView(buffer, 0);

view.setInt16(1, 42);
view.getInt16(1); // 42

Spezifikationen

Specification
ECMAScript® 2026 Language Specification # sec-dataview-constructor