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

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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
setBigUint64

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch