Segundo a documentação, JSON.stringify
verifica se o objeto a ser serializado possui o método toJSON
(e se tiver, o resultado deste é usado). Podemos ver isso também na especificação da linguagem:
- If Type(value) is Object or BigInt, then
a. Let toJSON be ? GetV(value, "toJSON").
b. If IsCallable(toJSON) is true, then
i. Set value to ? Call(toJSON, value, « key »).
Então uma forma de serializar um BigInt
seria definir o método toJSON
no seu protótipo:
Object.defineProperty(BigInt.prototype, 'toJSON', {
writable: true, configurable: true, enumerable: false,
value: function () {
// converte para uma string em algum formato específico
return 'BigInt::' + this.toString();
}
});
const params = { largeNum: 54740991n };
console.log(JSON.stringify(params)); // {"largeNum":"BigInt::54740991"}
Lembrando, claro, de todos os poréns de se alterar o protótipo de um objeto. Eu pessoalmente evito fazê-lo, por isso acho melhor a solução dada na outra resposta (usar uma função como segundo argumento de JSON.stringify
). De qualquer forma, fica registrada a opção.
As demais considerações da outra resposta também continuam valendo: como o resultado da serialização é uma string, você deve escolher algum formato específico para indicar que aquilo é um BigInt
, para que seja possível convertê-lo de volta ao desserializar. No exemplo acima eu adicionei o prefixo BigInt::
ao número, então para converter de volta seria assim:
const json = '{"largeNum":"BigInt::54740991"}';
const params = JSON.parse(json, function(key, val) {
// se a string começa com o prefixo, pega tudo depois dele
if (typeof val === 'string' && val.startsWith('BigInt::')) {
return BigInt(val.substring(8));
}
return val;
});
console.log(params.largeNum.toString()); // 54740991
console.log(typeof params.largeNum); // bigint
Lembrando de escolher um formato que não gere ambiguidades (por exemplo, se tiver outras strings que comecem com BigInt::
mas que depois não tenha um número, dará problemas e terá que escolher outro prefixo, ou ajustar a função para tratar estes casos).
Até porque a função usada no parse
confia "cegamente" no formato usado em stringify
. Em cenários controlados, nos quais você "sabe" exatamente que todas as strings contendo o prefixo são BigInt
's, isso não é um problema. Caso contrário, terá que incluir o tratamento dos casos excepcionais.
Vale notar que startsWith
não está disponível no IE, apesar de ter um suporte relativamente bom nos demais browsers. Se quiser mais compatibilidade, pode trocar por indexOf
:
const params = JSON.parse(json, function(key, val) {
// se a string começa com o prefixo, pega tudo depois dele
if (typeof val === 'string' && val.indexOf('BigInt::') === 0) {
return BigInt(val.substring(8));
}
return val;
});
Por fim, analisando de forma mais geral, o formato JSON (sim, é um formato de dados, não é algo exclusivo do JavaScript) é agnóstico com relação aos tipos de cada linguagem. Na definição do formato só existe number
(literais numéricos, como 42
, 1.25
ou 3e19
), e cada linguagem mapeia-os para seus respectivos tipos.
Quando os literais não são suficientes, outra opção passa a ser usar strings em um formato específico - como é feito, por exemplo, com datas: geralmente a data é convertida para um formato específico, e fica a cargo de cada parser saber interpretá-lo corretamente (daí podem surgir aberrações como essa).
No caso do BigInt
, o problema é similar. Os literais numéricos do formato JSON acabam sendo interpretados como o Number
do JavaScript. Só que valores acima de Number.MAX_SAFE_INTEGER
acabam dando problema:
const n = JSON.parse('111111111111111111111111111111111111111');
console.log(typeof n); // number
// mas o valor lido não é exatamente o que foi parseado
console.log(n.toLocaleString('pt-BR')); // 111.111.111.111.111.100.000.000.000.000.000.000.000
Então uma forma de resolver seria de fato criar a string em um formato específico que indique que o conteúdo deve ser interpretado como BigInt
(como feito acima). Ou então tratar qualquer string que contenha números como BigInt
.
Mas talvez não precise de tudo isso...
Eu sugiro dar um passo atrás e avaliar se precisa mesmo de um JSON. Acredito que está usando JSON porque esses dados devem ser enviados para outro lugar (outra aplicação/sistema). Se esse outro lugar "exige" que você mande um JSON e "não pode" mudar, aí não tem muito jeito. Mas se puder mudar, talvez seja interessante considerar outras alternativas.
Por que não mandar os valores diretamente? Se for uma requisição HTTP, poderia ser na própria query string, por exemplo:
http://url.com/api?valorBigInteger=123456789012345678901234567890
E aí você manda o valor usando valorBigInteger.toString()
, e o lado que recebe trata a string da maneira que achar melhor (cada linguagem terá seus tipos numéricos mais adequados para cada caso).
Aliás, o lado que recebe o JSON também é em JavaScript? Se for, precisa que seja sempre BigInt
(valores menores que Number.MAX_SAFE_INTEGER
não poderiam ser Number
)? Criar uma string com um formato customizado seria necessário somente se o lado que recebe os dados precisa de fato de um BigInt
(ou de um tipo similar na linguagem utilizada) e quer diferenciá-lo de outros tipos numéricos.
Caso contrário, mandar os dados separadamente e tratá-los um a um me parece o mais adequado. Ainda usando o exemplo acima da query string, a aplicação que recebe os dados sabe que determinado parâmetro deve ser convertido para um BigInt
(ou seja lá qual o tipo equivalente na linguagem do backend), pois este é o tipo esperado para aquele dado - assim nem precisaria customizar a serialização do JSON.
Mas novamente, se o lado que recebe "exige" que seja enviado um JSON e "precisa" que seja um BigInt
(e você não tem controle sobre ele), aí não tem muito jeito mesmo. Mas se puder mudá-lo, considere outras alternativas.
val.indexOf('prefixo_bigint::') === 0
+val.substring(16)
(use i o 16 fixo porque sabemos qual o "prefixo" desejado), imaginando que o cenário (que é a maioria) do parse de JSON seja para enviar grandes payloads, se o payload enviado for pequeno nem de JSON.stringify vai precisar, poderia fazer algo próprio na mão.indexOf
porstartsWith
por me parecer mais semanticamente adequado ao caso (ou talvez seja só "gosto pessoal" da minha parte). E também concordo que dependendo do caso, talvez nem seja necessário tudo isso...