Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

BigInt — inteiros exatos

BigInt(value) cria um valor primitivo bigint para cálculos inteiros exatos além do intervalo seguro de Number. Saiba como funciona a conversão, que restrições se aplicam às operações aritméticas e como produzir texto com toString(radix).

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

BigInt(value)
123n
value.toString(radix)

BigInt(value) devolve um valor primitivo do tipo bigint, que representa um número inteiro de precisão arbitrária dentro dos limites de recursos da implementação. Uma alternativa é um literal com o sufixo n, como 123n. A função e os literais fazem parte do ECMAScript 2020, não das Web APIs. new BigInt(1) lança um TypeError. A especificação da linguagem não é uma tabela de compatibilidade dos browsers; a presença de Node 24 num repositório não comprova o suporte nos browsers.

Para valores grandes, use texto, por exemplo BigInt("9007199254740993"): a conversão não consegue desfazer um arredondamento anterior de um valor Number. BigInt(1.5) lança um RangeError, e um texto inteiro inválido lança um SyntaxError. A conversão de true produz 1n, enquanto a de false produz 0n.

As operações aritméticas exigem tipos correspondentes: 1n + 1 lança um TypeError, enquanto 1n + 1n produz 2n. A divisão inteira trunca a parte fracionária em direção a zero: 7n / 2n produz 3n. A conversão através de Number(value) pode causar perda de precisão.

Distinga o nome BigInt.toString do método aplicado aos valores: a API efetiva é BigInt.prototype.toString, chamada como value.toString(radix). BigInt.toString() descreve a própria função, em vez de formatar um número inteiro. O método aplicado ao valor devolve texto sem o sufixo n; a base predefinida é 10. Antes de verificar o intervalo, o método converte radix num inteiro, truncando em direção a zero. Se o valor obtido estiver fora do intervalo de 2 a 36, inclusive, o método lança um RangeError. Por exemplo, (255n).toString(36.9) usa a base 36 e devolve "73".

Exemplos

const value = BigInt("9007199254740993");
const next = value + 2n;
console.log(typeof value);
console.log(next.toString());
console.log((255n).toString(16));
console.log((7n / 2n).toString());

Resultado

bigint
9007199254740995
ff
3

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes