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; 0x2AnUm 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.