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
- ECMAScript® Language Specification
- ECMAScript® Language Specification — ECMAScript Data Types and Values
- ECMAScript® Language Specification — Numbers and Dates
- ECMAScript® Language Specification — ECMAScript Data Types and Values
- ECMAScript® 2020 Language Specification
- Official reference — developer.mozilla.org: BigInt / toString