Como Formatar, Validar e Comparar JSON
JSON está em todo lugar — respostas de API, arquivos de config, linhas de log — e quase sempre chega até você minificado, escapado ou sutilmente quebrado. Aqui vai um fluxo rápido para entendê-lo.
1. Formate primeiro
JSON minificado é ilegível. Cole no formatador JSON e ele é reindentado em uma árvore que você consegue ler de fato. Formatar também revela a estrutura: colchetes faltando e vírgulas sobrando saltam aos olhos quando tudo fica em sua própria linha.
> Dica: se você só precisa encolher o JSON para o corpo de uma requisição, a > mesma ferramenta o minifica de volta.
2. Valide enquanto avança
Um formatador que falha ao analisar está dizendo algo: há um erro de sintaxe. Os suspeitos de sempre são:
- Uma vírgula sobrando depois do último item de um array ou objeto.
- Aspas simples em vez de aspas duplas em chaves ou strings.
- Quebras de linha ou aspas não escapadas dentro de uma string.
- Um comentário perdido — JSON não tem comentários.
Corrija um de cada vez e reformate até o documento analisar limpo.
3. Compare duas versões
Quando uma API muda ou um teste falha, você precisa saber o que difere. Jogue os dois payloads na ferramenta de comparação de JSON. Ela normaliza a ordem das chaves e a formatação primeiro, então você vê mudanças reais de valor em vez de ruído cosmético.
4. Converta quando precisar de outro formato
Às vezes a solução é um formato totalmente diferente:
- Precisa de um arquivo de config? Transforme em YAML com o
- Recebeu uma exportação de planilha? O
conversor CSV ⇄ JSON mapeia linhas em objetos e vice-versa.
Uma rotina repetível
- Formate para deixar legível.
- Valide corrigindo o que impede a análise.
- Compare com uma versão boa conhecida para achar mudanças.
- Converta para o que o próximo passo precisar.
Cada uma dessas etapas roda inteiramente no seu navegador, então até payloads de produção ficam na sua máquina. Salve o formatador JSON nos favoritos e você vai recorrer a ele o tempo todo.