This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

BigIntNumber 원시 값이 안정적으로 나타낼 수 있는 최대치인 253보다 큰 정수를 표현할 수 있는 내장 객체입니다.

구문

BigInt(value);

매개변수

value
생성할 객체의 값으로 지정할 숫자형 문자열 또는 정수 값.

참고: BigInt()new 키워드를 사용하지 않습니다.

설명

BigInt는 정수 리터럴의 뒤에 n을 붙이거나(10n) 함수 BigInt()를 호출해 만들 수 있습니다.

const theBiggestInt = 9007199254740991n;

const alsoHuge = BigInt(9007199254740991);
// ↪ 9007199254740991n

const hugeString = BigInt("9007199254740991");
// ↪ 9007199254740991n

const hugeHex = BigInt("0x1fffffffffffff");
// ↪ 9007199254740991n

const hugeBin = BigInt("0b11111111111111111111111111111111111111111111111111111");
// ↪ 9007199254740991n

Number와 비슷한 점도 있지만, 중요한 부분에서는 다릅니다. 예컨대 BigInt는 내장 Math 객체의 메서드와 함께 사용할 수 없고, 연산에서는 Number와 혼합해 사용할 수 없습니다.

NumberBigInt는 혼용해서 연산할 수 없으며, 우선 같은 자료형으로 변환해야 합니다.

변환 과정에서 BigIntNumber로 바뀌면 정확성을 잃을 수 있으니 주의해야 합니다.

자료형 정보

BigInttypeof 판별 결과는 "bigint"입니다.

typeof 1n === 'bigint'; // true
typeof BigInt('1') === 'bigint'; // true

Object로 감싼 BigInt는 일반적인 object 자료형으로 취급합니다.

typeof Object(1n) === 'object'; // true

연산자

+, *, -, **, % 연산자를 BigInt나 객체로 감싼 BigInt에서 사용할 수 있습니다.

const previousMaxSafe = BigInt(Number.MAX_SAFE_INTEGER);
// ↪ 9007199254740991

const maxPlusOne = previousMaxSafe + 1n;
// ↪ 9007199254740992n
 
const theFuture = previousMaxSafe + 2n;
// ↪ 9007199254740993n, this works now!

const multi = previousMaxSafe * 2n;
// ↪ 18014398509481982n

const subtr = multi – 10n;
// ↪ 18014398509481972n

const mod = multi % 10n;
// ↪ 2n

const bigN = 2n ** 54n;
// ↪ 18014398509481984n

bigN * -1n
// ↪ –18014398509481984n

/ 연산자도 정수에서 예상되는 결과를 동일하게 도출합니다. 그러나 BigIntBigDecimal이 아니므로, 연산의 결과는 언제나 소수점 미만을 반올림합니다. 즉, 정수가 아닌 결과는 나오지 않습니다.

소수점 결과를 포함하는 연산을 BigInt와 사용하면 결과가 언제나 반올림 됩니다.

const expected = 4n / 2n;
// ↪ 2n

const rounded = 5n / 2n;
// ↪ 2.5n이 아니라 2n

비교

BigIntNumber와 일치하지 않지만 동등합니다.

0n === 0
// ↪ false

0n == 0
// ↪ true

NumberBigInt는 일반적인 방법으로 비교할 수 있습니다.

1n < 2
// ↪ true

2n > 1
// ↪ true

2 > 2
// ↪ false

2n > 2
// ↪ false

2n >= 2
// ↪ true

배열의 요소로 함께 사용했을 땐 정렬도 가능합니다.

const mixed = [4n, 6, -12n, 10, 4, 0, 0n];
// ↪  [4n, 6, -12n, 10, 4, 0, 0n]

mixed.sort();
// ↪ [-12n, 0, 0n, 10, 4n, 4, 6]

Object로 감싼 BigInt의 경우 다른 객체와 마찬가지로 자기 자신과 비교했을 때만 일치합니다.

0n === Object(0n); // false
Object(0n) === Object(0n); // false

const o = Object(0n);
o === o // true

조건

BigIntBoolean으로 변환하는 곳, 즉 Boolean 함수와 논리 연산자(||, &&, !), 조건문에서는 Number처럼 행동합니다.

if (0n) {
  console.log('if에서 안녕!');
} else {
  console.log('else에서 안녕!');
}

// ↪ "else에서 안녕!"

0n || 12n
// ↪ 12n

0n && 12n
// ↪ 0n

Boolean(0n)
// ↪ false

Boolean(12n)
// ↪ true

!12n
// ↪ false

!0n
// ↪ true

메서드

BigInt.asIntN()
주어진 BigInt를 -2width-1과 2width-1-1의 범위로 자릅니다.
BigInt.asUintN()
주어진 BigInt를 0과 2width-1의 범위로 자릅니다.

속성

BigInt.prototype
BigInt 객체에 속성이나 메서드를 추가할 수 있습니다.

BigInt 인스턴스

모든 BigInt 인스턴스는 BigInt.prototype을 상속합니다. 프로토타입 객체를 변형해 모든 BigInt 인스턴스에 영향을 줄 수 있습니다.

메서드

BigInt.prototype.toLocaleString()
BigInt를 주어진 언어에 적합한 형태를 가진 문자열로 변환해 반환합니다. Object.prototype.toLocaleString() 메서드를 재정의합니다.
BigInt.prototype.toString()
BigInt의 값을 주어진 진수로 표현한 문자열을 반환합니다. Object.prototype.toString() 메서드를 재정의합니다.
BigInt.prototype.valueOf()
BigInt 객체의 원시 값 표현을 반환합니다. Object.prototype.valueOf() 메서드를 재정의합니다.

권장사항

변환

BigIntNumber로 변환하는 과정에서 정확도를 유실할 수 있으므로, 253보다 큰 값을 예상할 수 있는 경우 BigInt만 사용하는 것이 좋습니다.

암호화

BigInt가 지원하는 연산의 소요시간은 상수 시간이 아니기 때문에 암호화에 적합하지 않습니다.

예제

소수 구하기

function isPrime(p) {
  for (let i = 2n; i * i <= p; i++) {
    if (p % i === 0n) return false;
  }
  return true;
}

// BigInt를 받아 BigInt를 반환
function nthPrime(nth) {
  let maybePrime = 2n;
  let prime = 0n;
  
  while (nth >= 0n) {
    if (isPrime(maybePrime)) {
      nth -= 1n;
      prime = maybePrime;
    }
    maybePrime += 1n;
  }
  
  return prime;
}

nthPrime(20n)
// ↪ 73n

명세

Specification Status
BigInt Stage 3

브라우저 호환성

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
BigInt
Experimental
Chrome Full support 67Edge No support NoFirefox Full support 68IE No support NoOpera Full support 54Safari No support NoWebView Android Full support 67Chrome Android Full support 67Edge Mobile ? Firefox Android Full support 68Opera Android Full support 48Safari iOS No support NoSamsung Internet Android No support Nonodejs Full support 10.4.0

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.

같이 보기

문서 태그 및 공헌자

이 페이지의 공헌자: alattalatta, mdnwebdocs-bot
최종 변경자: alattalatta,