O que é o Embelezamento de JSON?
O embelezamento de JSON — também conhecido como formatação ou "pretty-printing" de JSON — é o processo de pegar uma string JSON compacta, minificada ou mal estruturada e reformatá-la com indentação consistente, quebras de linha e espaçamento para torná-la fácil de ler e compreender por humanos.
Embora o JSON minificado seja ideal para máquinas (carga útil menor, transmissão mais rápida), é muito difícil para desenvolvedores ler e trabalhar diretamente com ele. Um objeto JSON de linha única com centenas de propriedades e arrays aninhados profundamente torna-se praticamente ilegível sem a formatação adequada. O embelezamento de JSON resolve este problema transformando a string compacta em uma estrutura visualmente clara e hierarquicamente indentada.
Nosso embelezador de JSON utiliza a função json_encode() do PHP com a flag JSON_PRETTY_PRINT, que produz uma saída com indentação de 4 espaços — o padrão amplamente aceito na comunidade de desenvolvedores. Cada par chave-valor aparece em sua própria linha, os elementos de array são listados verticalmente e objetos aninhados são indentados em relação ao seu pai, tornando a estrutura geral dos dados imediatamente aparente.
Assim como nosso minificador, esta ferramenta também valida seu JSON. Se a entrada contiver quaisquer erros de sintaxe — chaves não fechadas, vírgulas em excesso, chaves não entre aspas — a ferramenta reportará o erro para que você possa corrigi-lo. Isso a torna também uma excelente ferramenta de linting de JSON.
Como Usar Este Embelezador de JSON
- Cole seu JSON: Copie qualquer string JSON — minificada, escrita à mão ou de uma resposta de API — e cole-a na área de texto à esquerda.
- Clique em "Embelezar JSON": A ferramenta valida e reformata seu JSON em uma estrutura limpa e indentada, exibida na área de texto à direita.
- Leia as mensagens de erro: Se o seu JSON tiver erros de sintaxe, a mensagem de erro explicará o problema (por exemplo, "Erro de sintaxe" ou "Erro de caractere de controle"). Corrija o problema e tente novamente.
- Copie e use: Clique em Copiar Saída para copiar o JSON formatado para sua área de transferência, para uso em seu editor, documentação ou revisão de código.
Por Que a Formatação de JSON é Importante?
- Inspeção de Respostas de API: Ao depurar APIs REST ou GraphQL, os corpos de resposta são frequentemente minificados. Embelezá-los torna imediatamente claro quais dados foram retornados e permite identificar valores inesperados ou campos ausentes.
- Revisão de Código e Documentação: Incluir JSON formatado corretamente em "pull requests", arquivos README e documentação de API torna a estrutura dos dados imediatamente compreensível para revisores e leitores.
- Edição de Arquivos de Configuração: Arquivos de configuração JSON (como
package.json,tsconfig.jsonouappsettings.json) devem ser legíveis por humanos para controle de versão e colaboração em equipe. - Aprendizado e Exploração: Ao explorar uma API ou conjunto de dados desconhecido, uma resposta JSON lindamente formatada ajuda você a entender rapidamente o esquema e identificar os campos de que precisa.
- Depuração e Testes: O JSON formatado facilita a inspeção manual de "fixtures" de teste, arquivos de "snapshot" e dados simulados para garantir que contenham os valores corretos.
Exemplo de Embelezamento de JSON
{"name":"Pan Tool","version":"1.0.0","tools":["url-encode","base64","json"],"free":true}
{
"name": "Pan Tool",
"version": "1.0.0",
"tools": [
"url-encode",
"base64",
"json"
],
"free": true
}
Para compactar JSON formatado para uso em produção, consulte nossa ferramenta Minificador de JSON.