Formatador e validador de JSON

Como ler o JSON de outra pessoa sem perder a cabeça

A maior parte do JSON que você encontra no trabalho nunca foi pensada para olhos humanos: a resposta de uma API chega em uma única linha enorme, um arquivo de configuração foi minificado por uma etapa de build, um registro de log tem um payload inteiro espremido dentro dele. O hábito que compensa é simples — cole primeiro, leia depois. Assim que estiver formatado, a indentação mostra a forma dos dados antes mesmo de você ler um único valor: quão profundo vai o aninhamento, quais partes são arrays de coisas repetidas e quais são configurações isoladas. Esse olhar estrutural muitas vezes já responde à pergunta sozinho, porque o campo que você estava procurando acaba estando dentro de um objeto diferente do que você imaginava. Nada nos dados muda quando você formata — só o espaçamento em branco muda — então a cópia formatada pode ser colada de volta com segurança em qualquer lugar que precisasse dela.

Quando o JSON é válido, mas ainda parece errado

Duas coisas costumam confundir as pessoas mesmo depois de uma análise bem-sucedida. A primeira é JSON dentro de JSON: um campo de texto cujo valor é, ele mesmo, um pedaço de JSON com escape, cheio de pares de barra invertida e aspas. Isso não é corrupção — algum sistema armazenou um documento como texto dentro de outro documento. Copie a string interna e formate-a sozinha para conseguir lê-la. A segunda são os números grandes. O próprio JSON permite inteiros de qualquer tamanho, mas o JavaScript armazena números como floats de 64 bits, então um ID com mais de quinze ou dezesseis dígitos pode silenciosamente mudar os últimos dígitos quando é analisado. Se você formatar um payload e um ID numérico longo sair sutilmente diferente, é por isso — e é a razão pela qual APIs bem projetadas enviam IDs longos como strings.

Para que serve realmente o Minificar

JSON minificado é para máquinas e espaços apertados: um payload colado em um comando curl, um valor espremido em uma variável de ambiente ou em uma única coluna de banco de dados, uma resposta que você quer o menor possível na transmissão. Formatar e minificar são espelhos perfeitos um do outro — você pode alternar os mesmos dados entre os dois o dia inteiro e nada além do espaçamento em branco muda. Um fluxo de trabalho organizado usa os dois: formate para ler e editar, minifique para enviar. E se os seus dados começaram a vida como uma planilha, e não como JSON, o conversor de CSV para JSON transforma linhas em um array de objetos — colar o resultado dele aqui é uma forma rápida de confirmar que ele é interpretado corretamente antes mesmo de o seu código vê-lo.

Os suspeitos de sempre quando o JSON não parseia

JSON é mais rígido que JavaScript: as chaves precisam estar entre aspas duplas, nada de vírgula sobrando depois do último item, nada de comentários e nada de aspas simples. O validador aqui roda enquanto você digita e informa a linha e a coluna do primeiro problema que encontrar.