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

CKTIS / JavaScript

Literal BigInt

Um literal BigInt é um número inteiro escrito com o sufixo n em minúscula, como 42n. Cria um valor bigint sem o arredondamento que afeta os valores Number grandes.

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

0n; 42n; 0b101010n; 0o52n; 0x2An

Um literal BigInt, como 42n, cria um valor primitivo do tipo bigint, não number. BigInt faz parte do ECMAScript 2020 e representa com exatidão números inteiros para além do intervalo de inteiros seguros de Number.

O n minúsculo tem de surgir imediatamente a seguir à representação do número inteiro. São suportadas as formas decimal (42n), binária (0b101010n), octal (0o52n) e hexadecimal (0x2An). 1.5n, 1e3n e 042n são erros de sintaxe. Em -42n, - é um operador unário, não faz parte do literal.

Operações aritméticas como + exigem tipos numéricos correspondentes: 42n + 1n funciona, mas 42n + 1 gera um TypeError. A divisão BigInt descarta a parte fracionária na direção de zero: 7n / 2n produz 3n. Converter um valor grande para Number pode causar perda de precisão.

Isto é sintaxe da linguagem, não uma Web API. O ambiente de execução tem de conseguir analisá-la; um navegador sem suporte não consegue executar um ficheiro que contenha um literal deste tipo. A presença de Node 24 num repositório não comprova o suporte nos navegadores de destino.

Exemplos

const value = 9007199254740993n;
console.log(typeof value);
console.log(String(value + 2n));
console.log(String(7n / 2n));
console.log(42n === 0x2An);

Resultado

bigint
9007199254740995
3
true

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