$cat~/glossario/bigint.md

BigInt

JavaScript

Tipo primitivo para inteiros arbitrariamente grandes, sufixo n.

bigint.mdmarkdown
01

seção

Explicação

BigInt — Tipo primitivo para inteiros arbitrariamente grandes, sufixo n.

Sufixo n cria literal BigInt: 123n. Não misture bigint e number em operações — o motor lança TypeError.

Ideal para contadores grandes, IDs de 64 bits e criptografia leve no client. JSON.stringify não serializa BigInt por padrão — defina replacer ou converta para string.

02

seção

Exemplo

snippetJavaScript
const id = 9007199254740993n;id + 1n // 9007199254740994n// id + 1 // TypeError
03

seção

Modo de uso

  • Representar IDs Snowflake ou hashes numéricos

  • Iterações que excedem MAX_SAFE_INTEGER

  • Parsing de strings inteiras com sufixo n

04

seção

Armadilhas comuns

  • Serializar BigInt em JSON sem tratamento

  • Dividir bigint trunca — não há decimais

05

seção

Termos relacionados