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.
setBigUint64() 方法在距 DataView 的起始位置的指定字节偏移处存储一个无符号的 64 位整数（unsigned long long 类型）值。
尝试一下
// 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
语法
dataview.setBigUint64(byteOffset, value [, littleEndian])
参数说明
- byteOffset
-
字节偏移量，为从视图的起始位置到数据存储位置的字节字节偏移量。
- value
-
作为一个 BigInt 类型设置的数值。满足一个无符号的 64 位整数的最大可能数值是
2n ** 64n - 1n(18446744073709551615n)。当发生溢出时，将会变成 0。 - littleEndian
-
为可选参数，表示这个 64 位整数是否以 little-endian 或者 big-endian 格式存储。如果设置为 false 或者未指定（undefined），将会写入一个 big-endian（大端模式：高位字节排放在内存的低地址端，低位字节排放在内存的高地址端）格式的数值。
返回值
抛出的错误
RangeError-
如果 byteOffset 设置导致存储该数值时超出了视图的末尾位置，将会抛出错误。
示例
使用 setBigUint64 方法
js
var buffer = new ArrayBuffer(8);
var dataview = new DataView(buffer);
dataview.setBigUint64(0, 3n);
dataview.getBigUint64(0); // 3n
规范
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-dataview.prototype.setbiguint64 |