Como tornar um documento JSON legível

Para que serve formatar JSON

Este formatador transforma texto JSON válido numa apresentação indentada, mais fácil de ler e rever. É útil quando recebe dados numa única linha, quando precisa de comparar a estrutura de objetos ou quando quer inspecionar rapidamente listas e campos aninhados.

Pode ajustar o número de espaços da indentação e, se necessário, ativar a ordenação das chaves dos objetos. A ordenação está desligada por predefinição. Os caracteres não ASCII, como os acentos portugueses, são preservados no resultado formatado.

Como formatar o texto JSON

1. Prepare o conteúdo JSON que pretende organizar. Cole o texto no campo de entrada. O conteúdo deve representar JSON válido, com aspas, chavetas, parênteses retos e vírgulas colocados corretamente.

2. Defina a indentação pretendida. Se não alterar esta opção, é usado o valor predefinido de 2 espaços. Uma indentação menor ocupa menos linhas; uma maior torna os níveis aninhados mais visíveis.

3. Se quiser uniformizar a ordem dos campos, ative a ordenação das chaves. Quando esta opção está ativa, as chaves dos objetos são apresentadas por ordem ordenada. Deixe-a desligada quando a ordem original for relevante para a sua leitura ou comparação.

4. Execute a formatação. Com JSON válido, o conteúdo é analisado e devolvido como texto indentado, e a operação fica marcada como bem-sucedida. Reveja o resultado para confirmar se a disposição corresponde ao que pretende.

5. Se não tiver conteúdo para colar, confirme se o campo contém apenas espaços ou está vazio. Essa situação é tratada como bem-sucedida, mas não produz conteúdo formatado e apresenta um diagnóstico de ausência de entrada.

Como interpretar o resultado

Um resultado bem-sucedido com conteúdo indica que o texto foi interpretado como JSON e reorganizado com a indentação escolhida. A informação passa a estar distribuída por linhas e níveis, sem que isso transforme o conteúdo num formato diferente de JSON. Se a ordenação estiver ativa, as chaves dos objetos aparecem na ordem ordenada; caso contrário, a opção permanece desligada por predefinição.

Quando a operação fica marcada como malsucedida, o conteúdo não foi formatado porque o JSON é inválido. Procure erros de sintaxe, como uma vírgula em falta, aspas incorretas ou um nome de chave sem aspas, corrija o texto e tente novamente. Um campo vazio ou composto apenas por espaços tem um tratamento próprio: não é apresentado como JSON formatado e surge um diagnóstico de ausência de entrada.

A ferramenta serve para formatar e embelezar dados JSON. Não deve ser usada como se corrigisse automaticamente JSON malformado: a entrada inválida conduz a uma operação malsucedida, em vez de ser reparada.

Exemplo prático

Ao rever dados de uma encomenda, uma pessoa cola {"cliente":"Inês","itens":[3,1]}, escolhe 4 espaços e ativa a ordenação das chaves.

Cole o texto, defina 4 espaços e ative a ordenação das chaves antes de executar a formatação.

O resultado surge como texto JSON distribuído por várias linhas, com 4 espaços de indentação, as chaves dos objetos em ordem ordenada e o carácter «ê» preservado.

Limitações

• A ferramenta não repara JSON malformado. Texto inválido fica marcado como malsucedido; uma entrada vazia ou só com espaços não produz conteúdo formatado.

Erros comuns

• Causa: o texto contém sintaxe JSON inválida, como uma vírgula ou aspas incorretas. Ação: reveja a estrutura, corrija o erro e volte a executar a formatação.
• Causa: o campo está vazio ou contém apenas espaços. Ação: cole um texto JSON antes de executar, porque esta entrada não produz conteúdo formatado.

Perguntas frequentes

O que acontece se eu deixar o campo JSON vazio?

Com JSON válido, a ferramenta devolve o conteúdo como texto indentado e marca a operação como bem-sucedida. Se o campo estiver vazio ou contiver apenas espaços, não há conteúdo formatado e é apresentado um diagnóstico de ausência de entrada.

Posso ordenar as chaves do JSON?

A ordenação das chaves está desligada por predefinição. Ao ativá-la, as chaves dos objetos são apresentadas por ordem ordenada.

A ferramenta corrige JSON inválido?

Uma entrada inválida faz com que a operação seja marcada como malsucedida, em vez de corrigir automaticamente o conteúdo. Verifique a sintaxe JSON e tente novamente.