BigInt64Array() constructor

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() 형식화 배열(TypedArray)의 생성자는 플랫폼의 바이트 순서를 따르는 2의 보수 64비트의 부호있는 정수 배열인 BigInt64Array을 생성합니다. 바이트 순서를 제어해야 하는 경우 대신 DataView를 사용합니다. 배열의 내용은 0n으로 초기화됩니다. 배열이 생성되면 객체의 메서드를 사용하거나 표준 배열 인덱스 구문(즉, 대괄호 표기법 사용)을 사용하여 배열의 요소를 참조할 수 있습니다.

구문

js
new BigInt64Array()
new BigInt64Array(length)
new BigInt64Array(typedArray)
new BigInt64Array(object)

new BigInt64Array(buffer)
new BigInt64Array(buffer, byteOffset)
new BigInt64Array(buffer, byteOffset, length)

참고: BigInt64Array()는 오직 new로만 생성할 수 있습니다. new 없이 호출하면 TypeError 예외가 발생합니다.

매개변수

TypedArray를 참조하세요.

예외

TypedArray를 참조하세요.

예제

BigInt64Array을 생성하기 위한 각기 다른 방법

js
// 길이로부터
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

// 배열로부터
const x = new BigInt64Array([21n, 31n]);
console.log(x[1]); // 31n

// 다른 TypedArray로부터
const y = new BigInt64Array(x);
console.log(y[0]); // 21n

// ArrayBuffer로 부터
const buffer = new ArrayBuffer(64);
const z = new BigInt64Array(buffer, 8, 4);
console.log(z.byteOffset); // 8

// 순회로부터
const iterable = (function* () {
  yield* [1n, 2n, 3n];
})();
const bigint64FromIterable = new BigInt64Array(iterable);
console.log(bigint64FromIterable);
// BigInt64Array [1n, 2n, 3n]

명세서

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

브라우저 호환성

같이 보기