Formatar JSON

O que sobrevive à ida e volta

Formatar é interpretar e imprimir de novo, e os números são a única parte mantida como o texto que você digitou. Isso vai além do caso dos inteiros grandes que o aviso contabiliza: qualquer número cuja grafia mais curta em JavaScript seja diferente da sua é reescrito a partir do original, então 1.10 mantém o zero final, 1e5 continua em notação exponencial e um zero negativo continua negativo. Só os inteiros inseguros entram na contagem do aviso, porque é neles que a alternativa seria corrupção silenciosa, e não apenas uma grafia arrumada.

As strings não são mantidas como texto. Os escapes são decodificados quando o documento é lido e escritos do zero quando ele é impresso, então \u0041 volta como A e uma barra com escape volta sem ele. O valor é idêntico e os bytes não, o que só importa em uma situação — e importa muito nela: se algo mais adiante compara dois arquivos JSON byte a byte, passar um deles por um formatador não é uma operação neutra.

Dois comportamentos no nível dos objetos valem a pena conhecer antes de confiar em uma reformatação. Chaves duplicadas são resolvidas em silêncio, e a última vence, exatamente como o parser do próprio navegador as resolve — um documento com dois campos “id” é formatado sem reclamar e volta com um só, e nada avisa que o outro existia. E a ordem das chaves só segue a do seu arquivo para chaves que não são números inteiros: um objeto com “1”, “2” e “name” volta com as chaves numéricas primeiro, em ordem numérica, porque é assim que o próprio JavaScript ordena as propriedades de um objeto. Chaves comuns mantêm a ordem em que você as escreveu.

Quando você precisa de outra coisa

Se o que você tem é um tsconfig.json, uma configuração do ESLint ou um arquivo de configurações do VS Code, esta página vai apontar os comentários e as vírgulas finais em vez de formatar em volta deles — a resposta certa para uma ferramenta de JSON e a ferramenta errada para o seu arquivo. Esses arquivos são JSONC, e o seu editor já os interpreta; na linha de comando, o json5 e o dasel leem esses arquivos sem fingir que são JSON.

Para qualquer coisa além de reindentar, um formatador é o tipo errado de ferramenta. O jq faz em uma expressão o que uma caixa de colar não tem como controlar: jq -S . ordena as chaves de todos os objetos para que duas respostas possam ser comparadas, jq 'del(.token)' remove um campo antes de você mostrar um payload a alguém, e jq -c transforma um array de objetos no JSON Lines que um pipeline espera. Ele também lê um arquivo em vez da área de transferência, o que faz diferença quando o documento é grande demais para selecionar com conforto.