Formatador JSON

O que a formatação faz de fato

Formatar JSON é uma análise seguida de uma nova serialização. O documento é lido como um valor e depois reescrito com uma quebra de linha após cada vírgula e uma indentação fixa por nível de aninhamento. Nada muda no modelo de dados — só mudam os bytes entre os tokens.

Essa distinção importa porque duas coisas são normalizadas nesse ciclo, e vale saber quais:

• Números são reimpressos na forma mais curta. 1.50 vira 1.5, 1e3 vira 1000 e -0 vira 0. O valor é idêntico; a escrita fica canônica.
• Escapes desnecessários desaparecem. "\u0041" vira "A". Os escapes que o JSON exige — aspas, barras invertidas e caracteres de controle — são mantidos.
• Inteiros acima de 2⁵³−1 perdem precisão. Isso é uma propriedade do tipo numérico do JavaScript, não desta ferramenta. Carregue IDs grandes como strings.

Escolhendo a largura da indentação

O seletor de indentação se aplica na hora e é lembrado na sua próxima visita. Como regra geral:

• 2 espaços — respostas de API, qualquer coisa que você vá colar em um code review e tudo que precise casar com a saída de JSON.stringify(v, null, 2).
• 4 espaços — arquivos de configuração editados à mão, com pouco aninhamento e linhas longas.
• Tabulação — arquivos versionados em um repositório onde cada pessoa prefere uma largura diferente.

O mesmo trabalho na linha de comando

jq . input.json formata com indentação de 2 espaços, a mesma saída que esta página produz na configuração padrão. A versão do navegador ganha quando o JSON está na área de transferência e não em um arquivo, quando você prefere navegar por uma árvore em vez de ler 4.000 linhas, ou quando a carga contém algo que você prefere não passar por uma ferramenta que não auditou.

Formatar um documento que não é analisado

Um formatador não indenta o que não consegue ler, então um documento inválido devolve um erro em vez de saída. O painel mostra a linha, a coluna, a linha de origem com um marcador exatamente abaixo do caractere e o que o analisador esperava ali. Ir para o erro coloca o cursor nesse caractere. Se o problema for um dos quase-JSON comuns, Reparar corrige e formata em um único passo — veja o validador para o catálogo completo de causas.