CKTIS / JavaScript
Tipos numéricos: Number e BigInt
JavaScript tem dois tipos numéricos primitivos: Number para cálculos de vírgula flutuante e BigInt para inteiros sem uma largura fixa em bits. Diferem na precisão, na divisão e nas regras de conversão.
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
const value = 42;
const fraction = 0.5;
const integer = 42n;
Number(integer);
BigInt(value);Number representa inteiros e frações no formato IEEE 754 binary64. Os literais inteiros comuns não têm um tipo int separado: typeof 42 devolve "number". Este tipo inclui também NaN, Infinity, -Infinity e dois zeros: +0 e -0. Muitas frações decimais não podem ser representadas com exatidão, pelo que 0.1 + 0.2 === 0.3 resulta em false.
O intervalo de inteiros seguros de Number vai de -(2 ** 53 - 1) a 2 ** 53 - 1. Fora deste intervalo, não é possível distinguir todos os inteiros consecutivos, embora alguns continuem a ser representados com exatidão. Use Number.isSafeInteger(value) para verificar esta propriedade.
BigInt representa inteiros sem uma largura fixa em bits; na prática, as dimensões são limitadas pelos recursos da implementação. Os literais usam o sufixo n, como 42n, e typeof 42n devolve "bigint". Não suporta frações, NaN nem infinitos. A divisão trunca em direção a zero: 5n / 2n produz 2n, enquanto 5 / 2 produz 2.5.
Não misture estes tipos em operações aritméticas: 2n + 3 lança um TypeError. Converta explicitamente com BigInt(value) ou Number(value). Converter um Number não inteiro para BigInt lança um RangeError, enquanto a conversão no sentido inverso pode causar perda de precisão. Crie inteiros grandes a partir de um literal BigInt ou de uma cadeia de caracteres, não de um Number já arredondado. As comparações diferem da aritmética: 2n === 2 é false, mas 2n < 3 é true.
Exemplos
console.log(typeof 42);
console.log(typeof 42n);
console.log(0.1 + 0.2 === 0.3);
console.log(Number.isSafeInteger(9007199254740992));
console.log(String(9007199254740993n + 1n));
console.log(5 / 2);
console.log(String(5n / 2n));
console.log(String(2n + BigInt(3)));
try {
console.log(2n + 3);
} catch (error) {
console.log(error.name);
}Resultado
number bigint false false 9007199254740994 2.5 2 5 TypeError
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.