BigInt64Array
The BigInt64Array
typed array represents an array of 64-bit signed integers in the platform byte order. If control over byte order is needed, use DataView
instead. The contents are initialized to 0n
. Once established, you can reference elements in the array using the object's methods, or by using standard array index syntax (that is, using bracket notation).
BigInt64Array
is a subclass of the hidden TypedArray
class.
Constructor
BigInt64Array()
-
Creates a new
BigInt64Array
object.
Static properties
Also inherits static properties from its parent TypedArray
.
BigInt64Array.BYTES_PER_ELEMENT
-
Returns a number value of the element size.
8
in the case ofBigInt64Array
.
Static methods
Inherits static methods from its parent TypedArray
.
Instance properties
Also inherits instance properties from its parent TypedArray
.
These properties are defined on BigInt64Array.prototype
and shared by all BigInt64Array
instances.
BigInt64Array.prototype.BYTES_PER_ELEMENT
-
Returns a number value of the element size.
8
in the case of aBigInt64Array
. BigInt64Array.prototype.constructor
-
The constructor function that created the instance object. For
BigInt64Array
instances, the initial value is theBigInt64Array
constructor.
Instance methods
Inherits instance methods from its parent TypedArray
.
Examples
Different ways to create a BigInt64Array
js
// From a length
const 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
const x = new BigInt64Array([21n, 31n]);
console.log(x[1]); // 31n
// From another TypedArray
const y = new BigInt64Array(x);
console.log(y[0]); // 21n
// From an ArrayBuffer
const buffer = new ArrayBuffer(64);
const z = new BigInt64Array(buffer, 8, 4);
console.log(z.byteOffset); // 8
// From an iterable
const iterable = (function* () {
yield* [1n, 2n, 3n];
})();
const bigint64FromIterable = new BigInt64Array(iterable);
console.log(bigint64FromIterable);
// BigInt64Array [1n, 2n, 3n]
Specifications
Specification |
---|
ECMAScript Language Specification # sec-typedarray-objects |
Browser compatibility
BCD tables only load in the browser