Formatador JSON x JSON Repair

Um formatador deixa um JSON válido mais legível. Uma ferramenta de reparo tenta transformar «quase JSON» em JSON válido antes de formatá-lo.

Formatter

Um formatter JSON espera entrada JSON válida. Ele parseia o documento e o imprime com indentação, quebras de linha e espaçamento consistentes. Formatters são ótimos para logs legíveis, respostas de API, fixtures, arquivos de configuração e revisar objetos aninhados que já parseiam corretamente.

Validator

Um validator responde uma única pergunta: isso é JSON estrito? Ele deve falhar cedo em comentários, aspas simples, chaves sem aspas, vírgulas finais, literais Python e outras sintaxes não-JSON. Validar é o primeiro passo certo quando você precisa de certeza de que outro parser vai aceitar o documento.

Ferramenta de reparo

Uma ferramenta de reparo é feita para «quase-JSON»: dados com uma estrutura claramente pretendida, mas com sintaxe de JavaScript, Python, markdown ou comentários humanos. O reparo consegue transformar o texto em JSON estrito e depois formatar o resultado para facilitar a leitura.

Minifier

Um minifier remove espaços em branco desnecessários de JSON válido. Ele não corrige erros de sintaxe. Use minificação quando o tamanho do payload importa ou quando você vai copiar um valor compacto para uma variável de ambiente, um parâmetro de query ou um exemplo de linha de comando.

Qual ferramenta escolher

Use Validate quando precisar de um sim ou não. Use Format quando a entrada já é válida mas difícil de ler. Use Repair quando o JSON.parse falha e a origem é um objeto JavaScript, resposta de LLM, configuração comentada ou trecho editado à mão. Use Diff quando tem dois documentos válidos ou reparados e precisa entender o que mudou.

Risco do reparo automático

Ferramentas de reparo arrumam sintaxe, mas não devem decidir o significado de negócio. Se o reparo só mexe em aspas, comentários ou vírgulas, a intenção costuma ser clara. Se precisa adivinhar um colchete que falta, um nome de campo ou um valor, revise a saída com cuidado antes de usar em produção.

Fluxo prático

Para entrada bagunçada: repare primeiro, formate depois, valide em terceiro e compare com um exemplo conhecido se o payload controla o comportamento da aplicação. Essa sequência dá saída legível sem pular o parser estrito final.