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 Methode setBigUint64() von DataView-Instanzen nimmt einen BigInt-Wert und speichert ihn als 64-Bit-unsigned Integer in den 8 Bytes, die an dem angegebenen Byte-Offset dieses DataView beginnen. Es gibt keine Ausrichtungsbeschränkung; mehrbyteige Werte 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

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

Parameter

byteOffset

Der Offset in Bytes, vom Beginn des Views, an dem die Daten gespeichert werden.

value

Der Wert, der als BigInt gesetzt werden soll. Wie der Wert in Bytes enkodiert wird, finden Sie unter Value encoding and normalization.

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 eingestellt ist, dass er über das Ende des Views hinaus gespeichert würde.

Beispiele

Verwendung von setBigUint64()

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

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch