Como formatar JSON passo a passo

Para que serve formatar JSON

O JSON Formatter serve para tornar texto JSON mais legível e verificar se pode ser interpretado corretamente. É útil quando recebe um objeto numa só linha, precisa de organizar a indentação ou quer uniformizar a ordem das chaves antes de consultar ou partilhar o conteúdo.

A ferramenta trabalha com texto JSON e pode conservar caracteres Unicode, como acentos e letras de outros alfabetos, quando o conteúdo é válido. A ordenação das chaves e o modo compacto são opções independentes da indentação.

Como formatar e verificar o JSON

1. Introduza o texto JSON no campo de entrada. Pode colar, por exemplo, um objeto ou uma lista em formato JSON. Se deixar o campo vazio ou introduzir apenas espaços, a ferramenta trata a operação como bem-sucedida, mas indica que não foi fornecida entrada JSON.

2. Escolha o valor de indentação. O valor predefinido é 2, mas pode selecionar outro número para controlar o espaço usado em cada nível do resultado.

3. Se necessário, ative a ordenação das chaves. Quando esta opção está ligada, as chaves dos objetos são ordenadas no texto JSON formatado. Deixe-a desligada se quiser conservar a ordem apresentada na entrada, dentro do comportamento suportado pela ferramenta.

4. Se precisar de uma versão sem quebras de linha nem indentação, ative a saída compacta. Nesse modo, o JSON serializado usa separadores compactos entre elementos e propriedades.

5. Execute o processamento e leia o resultado. Para texto válido, é produzido JSON formatado. Para texto malformado, reveja os detalhes do erro de análise e corrija a entrada antes de tentar novamente.

Como interpretar o resultado

Um resultado bem-sucedido com conteúdo significa que o texto fornecido foi interpretado como JSON e devolvido em formato organizado. A apresentação depende das opções escolhidas: uma indentação maior cria mais espaço visual, a ordenação altera a disposição das chaves dos objetos e a saída compacta remove a formatação baseada em indentação.

Se a análise falhar, o texto submetido é mantido como conteúdo devolvido e são incluídos detalhes do erro. Isso permite localizar a correcção necessária, como uma vírgula indevida, uma chave sem aspas ou um valor malformado. Uma entrada vazia é uma situação diferente: não é apresentada como JSON formatado, porque não foi fornecido conteúdo.

A verificação está limitada à interpretação e formatação de texto JSON. Não deve ser entendida como avaliação de um esquema de dados ou das regras específicas de uma aplicação.

Exemplo prático

Uma pessoa recebe o texto JSON {"nome":"Ana","cidade":"Porto"} numa só linha e quer torná-lo mais legível.

Introduza o objecto, defina a indentação como 4 e active a ordenação das chaves antes de executar o processamento.

O resultado deverá ser JSON formatado em várias linhas, com quatro espaços por nível e as chaves dos objectos apresentadas segundo a ordenação seleccionada.

Limitações

• A ferramenta trata da interpretação e formatação de texto JSON; o resultado não representa uma verificação de esquema nem confirma regras específicas de uma aplicação.

Erros comuns

• Uma vírgula extra ou uma chave sem aspas pode tornar o JSON malformado. Consulte os detalhes do erro de análise, corrija o texto e execute o processamento novamente.

Perguntas frequentes

O que acontece se deixar a entrada JSON vazia?

Se o texto contiver apenas espaços, a ferramenta trata a operação como bem-sucedida, mas indica que não foi fornecida entrada JSON. Para obter conteúdo formatado, introduza um JSON válido.

É possível formatar JSON com acentos?

Sim, quando o texto é JSON válido, os caracteres Unicode podem ser conservados no texto formatado. O resultado continua dependente de a entrada poder ser interpretada como JSON.

Para que serve a saída compacta?

Quando a saída compacta está ativada, a serialização usa separadores compactos entre vírgulas e dois-pontos, em vez da apresentação com indentação. Se quiser legibilidade por níveis, mantenha essa opção desligada.