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

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.

Fontes