DataView.prototype.getBigInt64()

Baseline 已广泛支持

此功能已成熟,并可在多种设备和浏览器版本上运行。自 2021 年 9 月起,所有浏览器均已支持此功能。

DataView 实例的 getBigInt64() 方法会读取此 DataView 中指定字节偏移量开始的 8 个字节,并将它们解释为 64 位有符号整数。没有对齐约束;多字节值可以从任何边界内的偏移量获取。

试一试

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

// Highest possible BigInt value that fits in a signed 64-bit integer
const max = 2n ** (64n - 1n) - 1n;

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

console.log(view.getBigInt64(1));
// Expected output: 9223372036854775807n

语法

js
getBigInt64(byteOffset)
getBigInt64(byteOffset, littleEndian)

参数

byteOffset

要从中读取数据的视图起始位置的字节偏移量。

littleEndian 可选

指示数据是以小端序或大端序格式存储的。如果为 falseundefined,则读取大端序值。

返回值

一个 BigInt,范围从 -263 到 263-1(包括两端)。

异常

RangeError

如果 byteOffset 设置为读取超出视图末尾,则会抛出此错误。

示例

使用 getBigInt64()

js
const { buffer } = new Uint8Array([0, 1, 2, 3, 4, 5, 6, 7, 8, 9]);
const dataview = new DataView(buffer);
console.log(dataview.getBigInt64(1)); // 72623859790382856n

规范

规范
ECMAScript® 2026 语言规范
# sec-dataview.prototype.getbigint64

浏览器兼容性

另见