DataView.prototype.setBigUint64()

Baseline Widely available

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

Die setBigUint64() Methode von DataView Instanzen nimmt ein BigInt und speichert es als 64-Bit-unsigned-Integer in den 8 Bytes, beginnend beim angegebenen Byte-Offset dieses DataView. Es gibt keine Ausrichtungsbeschränkung; Mehrbytewerte können an jedem Offset innerhalb der Grenzen gespeichert werden.

Probieren Sie es aus

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

// Highest possible BigInt value that fits in an unsigned 64-bit integer
const max = 2n ** 64n - 1n;

const view = new DataView(buffer);
view.setBigUint64(1, max);

console.log(view.getBigUint64(1));
// Expected output: 18446744073709551615n

Syntax

setBigUint64(byteOffset, value)
setBigUint64(byteOffset, value, littleEndian)

Parameter

byteOffset: Der Offset in Bytes vom Anfang der Ansicht, in dem die Daten gespeichert werden sollen.
value: Der Wert, der als BigInt gesetzt werden soll. Für Informationen, wie der Wert in Bytes kodiert wird, siehe Wertkodierung und Normalisierung.
littleEndian Optional: Gibt an, ob die Daten im Little- oder Big-Endian Format gespeichert werden. Wenn false oder undefined, wird ein Big-Endian-Wert geschrieben.

Rückgabewert

undefined.

Ausnahmen

RangeError: Wird ausgelöst, wenn der byteOffset so gesetzt wird, dass er jenseits des Endes der Ansicht speichern würde.

Beispiele

Verwendung von setBigUint64()

const buffer = new ArrayBuffer(10);
const dataview = new DataView(buffer);
dataview.setBigUint64(0, 3n);
dataview.getBigUint64(1); // 768n

Spezifikationen

Specification
ECMAScript® 2026 Language Specification # sec-dataview.prototype.setbiguint64