Embelezar JSON
O embelezador de JSON transforma dados JSON sem formatação, minificados ou desorganizados em código visualmente limpo e de fácil leitura. Ele oferece níveis de indentação configuráveis (2 espaços, 4 espaços ou tabs), ordenação alfabética de chaves para leitura visual, controles de escape unicode e tolerância a comentários, executando inteiramente dentro do seu navegador.
Como funciona o Embelezar JSON?
Em arquiteturas de API modernas, logs, rastros de rede e payloads de webhook chegam como strings contínuas de linha única. Ler e auditar texto minificado à mão causa fadiga cognitiva severa e aumenta a chance de deixar passar falhas de segurança, tokens ausentes ou tipos de dados malformados.
O embelezador de JSON da ToolsByUs restabelece a hierarquia visual por meio de desserialização estruturada de AST e geração de indentação disciplinada:
- Ordenação lexical previsível: ativar
Sort Keyscoloca as propriedades dos objetos em ordem alfabética em todos os níveis da hierarquia do documento. Isso padroniza a localização das propriedades e torna a leitura visual instantânea durante revisão de código ou resolução de problemas. - Larguras de indentação configuráveis: dois espaços é a convenção do JavaScript, quatro é a norma em Python e em boa parte do mundo backend, e um tab de teclado deixa cada leitor escolher a própria largura. Nenhuma é mais correta que as outras; a única resposta errada é misturá-las em um mesmo arquivo.
- Estilo de chaves e formatação de delimitadores: escolha entre chaves de abertura compactas tradicionais (estilo K&R na mesma linha) e formatação expandida, que maximiza a leitura vertical em arrays de coleções profundamente aninhados.
- Escape Unicode seguro: escolha se os caracteres não ASCII (como strings multilíngues, emojis ou símbolos de moedas internacionais) são preservados em UTF-8 nativo ou escapados para sequências de escape hexadecimais
\uXXXXseguras, conforme a Seção 7 do RFC 8259. - Remoção de comentários JSONC: tolera comentários de pessoa desenvolvedora (
//e/* */) comuns em arquivos de configuração comotsconfig.jsonou nas configurações do VS Code, convertendo-os em JSON padrão compatível com RFC. - Garantia de processamento local: o embelezamento acontece 100% no navegador. Payloads proprietários, tokens de API e registros de clientes nunca cruzam a rede.
O embelezador funciona analisando o texto de entrada em uma AST, percorrendo os nós recursivamente com rastreamento de profundidade, emitindo espaços ou tabs conforme as larguras de indentação configuradas, inserindo quebras de linha entre os pares de objetos e os itens de arrays, e acrescentando as chaves de fechamento correspondentes nos níveis de indentação correspondentes.
Entrada minificada, sem formatação
{"id":42,"title":"Log Event","active":true,"tags":["prod","payment"]}Exemplo de saída
{
"active": true,
"id": 42,
"tags": [
"prod",
"payment"
],
"title": "Log Event"
}Quais opções e casos-limite o Embelezar JSON suporta?
| Parâmetro | Tipo | Padrão | Comportamento e casos-limite |
|---|---|---|---|
| Indentação: 2 espaços | Estilo de Formatação | 2 espaços | Convenção padrão da web e TypeScript que minimiza a rolagem horizontal em árvores profundamente aninhadas. |
| Indentação: 4 espaços | Estilo de Formatação | 4 espaços | Indentação visual de alto contraste, favorecida em sistemas de backend, Python e terminais de linha de comando. |
| Indentação: tabulação | Estilo de Formatação | \t | Caracteres de tabulação de hardware, permitindo que cada pessoa desenvolvedora personalize as larguras de tabulação em seu IDE local. |
| Ordenar Chaves | Normalização | true | Ordena alfabeticamente todas as chaves de dicionário em cada nível de aninhamento para uma varredura visual consistente e saída reprodutível. |
| Escapar Unicode | Opção de Codificação | false | Codifica caracteres fora do ASCII em sequências hex \uXXXX para camadas de transporte legadas que só aceitam ASCII. |
| Remoção de Comentários JSONC | Recuperação de Sintaxe | Ativo | Remove comentários de linha única e múltiplas linhas das entradas JSONC sem corromper literais de string que contenham barras. |
| Limite de Entrada | Limite de Desempenho | 8 MB | É imposto, não é aspiracional. A formatação é executada na thread principal, portanto, um colar maior é recusado com uma explicação, em vez de congelar a aba. Acima de 2 MB, um aviso aparece. Para documentos maiores, use a ferramenta Comparar JSON, que processa em um Web Worker. |
Perguntas frequentes
Qual é a diferença entre um embelezador e um formatador?
Embora os dois compartilhem o motor de serialização central, o embelezador dá ênfase à ergonomia visual, à legibilidade e à compreensão humana (como ordenação alfabética de chaves, contraste claro e opções de layout de chaves), enquanto o formatador foca em conformidade sintática rigorosa, remoção de comentários JSONC e convenções de formatação de CLI.
Por que devo ordenar as chaves JSON em ordem alfabética?
Em JSON (RFC 8259), a ordem das chaves é arbitrária. Ao inspecionar payloads complexos com dezenas de chaves, tê-las em ordem alfabética permite que pessoas desenvolvedoras localizem campos específicos rapidamente, sem varrer o objeto inteiro, e garante que commits no git não mostrem churn de diff falso causado pela ordem aleatória de serialização das chaves.
Como o embelezador lida com tabs versus espaços?
Você pode escolher 2 espaços, 4 espaços ou caracteres de tab. Os espaços garantem renderização idêntica em todos os editores, enquanto os tabs respeitam a preferência pessoal de largura de tabulação de cada pessoa.
Posso colar JSON com comentários no embelezador?
Sim! O embelezador tolera comentários de linha única (//) e de múltiplas linhas (/* */), removendo-os de forma limpa e preservando a sintaxe válida do RFC 8259 na saída, e avisa você se algum comentário foi removido.
Quando devo ativar o escape Unicode?
Ative o escape Unicode ao enviar payloads JSON para APIs de backend legadas ou para protocolos que só suportam transmissão ASCII de 7 bits. Para APIs HTTP modernas, o UTF-8 nativo é o recomendado.
Meus dados embelezados são enviados para algum servidor?
Não. Toda a lógica de parsing e formatação executa estritamente no runtime do seu navegador local. Zero bytes são enviados, o que garante conformidade total com a GDPR e com as políticas internas de segurança.