BigInt64Array

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.

BigInt64Array 类型的数组代表由 64 位有符号整数组成的数组。如果需要控制字节顺序的话，请使用 DataView 代替。内容初始化为 0n。一旦建立，就可以使用对象的方法或使用标准数组索引语法（即使用中括号表示法）引用数组中的元素。

构造函数

BigInt64Array(): 创建一个新的 BigInt64Array 对象。

静态属性

BigInt64Array.BYTES_PER_ELEMENT: 返回一个元素大小的数字值。BigInt64Array 返回 8 。

静态方法

BigInt64Array.from(): 从类数组或者可迭代对象创建一个新的 BigInt64Array，另请参见 Array.from()。
BigInt64Array.of(): 从可变数量的参数创建一个新的 BigInt64Array，另请参见 Array.of()。

实例属性

BigInt64Array.prototype.buffer: 返回被 BigInt64Array 引用的 ArrayBuffer。这在 BigInt64Array 对象构建时期就被锁定了，所以是只读的。
BigInt64Array.prototype.byteLength: 返回 BigInt64Array 从 ArrayBuffer 开始的长度（以字节为单位）。这在 BigInt64Array 对象构建时期就被锁定了，所以是只读的。
BigInt64Array.prototype.byteOffset: 返回 BigInt64Array 从 ArrayBuffer 开始的偏移量（以字节为单位）。这在 BigInt64Array 对象构建时期就被锁定了，所以是只读的。
BigInt64Array.prototype.length: 返回 BigInt64Array 中被保留的元素个数。这在 BigInt64Array 对象构建时期就被锁定了，所以是只读的。

实例方法

从其父接口 TypedArray 继承实例方法。

示例

不同的方法去创建一个 `BigInt64Array`

// From a length
var bigint64 = new BigInt64Array(2);
bigint64[0] = 42n;
console.log(bigint64[0]); // 42n
console.log(bigint64.length); // 2
console.log(bigint64.BYTES_PER_ELEMENT); // 8

// From an array
var arr = new BigInt64Array([21n, 31n]);
console.log(arr[1]); // 31n

// From another TypedArray
var x = new BigInt64Array([21n, 31n]);
var y = new BigInt64Array(x);
console.log(y[0]); // 21n

// From an ArrayBuffer
var buffer = new ArrayBuffer(32);
var z = new BigInt64Array(buffer, 0, 4);

// From an iterable
var iterable = (function* () {
  yield* [1n, 2n, 3n];
})();
var bigint64 = new BigInt64Array(iterable);
// BigInt64Array[1n, 2n, 3n]

规范

Specification
ECMAScript® 2026 Language Specification # sec-typedarray-objects