JavaScript · Intermediário · Inglês · Técnico
JSON.stringify
Função que converte um valor JavaScript em texto JSON. Ignora undefined, funções e símbolos em objetos, e lança erro em referências circulares e em BigInt.
Onde usar
Usado para enviar dados a APIs e guardar objetos em localStorage. Em code review, surpreende que chaves com undefined somem e que Date vira string, o que quebra a ida e volta com JSON.parse.
Em código
const o = { a: 1, b: undefined, c: () => 1 };
console.log(JSON.stringify(o));
// {"a":1}
console.log(JSON.stringify([undefined]));
// [null]
console.log(JSON.stringify(new Map()));
// {}Exemplos
JSON.stringify drops keys whose value is undefined.
O JSON.stringify descarta chaves cujo valor é undefined.
It threw because the object has a circular reference.
Lançou erro porque o objeto tem uma referência circular.
Cuidado
Esperar que a ida e volta preserve tudo, quando Date vira string, Map vira {} e undefined desaparece.
Sinônimos
serializar
Antônimos
JSON.parse