O que é formatação JSON?
JSON (JavaScript Object Notation) é um formato leve de intercâmbio de dados baseado em texto, definido pela RFC 8259 e ECMA-404. Um documento JSON é uma árvore com seis tipos de valor — object, array, string, number, boolean e null. Formatar adiciona espaços em branco para que humanos possam ler essa árvore; minificar remove os espaços para que máquinas possam transmiti-la mais rápido pela rede.
Como funciona a formatação JSON?
Sua entrada é processada inteiramente no seu navegador usando as funções integradas JSON.parse e JSON.stringify. Os passos principais são:
- A entrada é lida do textarea e os espaços em branco no início e no fim são removidos.
- O navegador a analisa com
JSON.parse. Se a entrada não for JSON válido, o analisador lança umSyntaxErrorque é capturado e exibido com a linha e a coluna onde parou. - Quando a entrada é válida, o valor analisado é reemitido com
JSON.stringify(value, null, indent), ondeindenté a indentação que você selecionou (2 espaços, 4 espaços ou um caractere de tabulação). - Para minificar,
JSON.stringify(value)é chamado sem o argumento de indentação, produzindo a forma válida mais curta do mesmo valor, sem espaços em branco supérfluos. - A saída é escrita no textarea de leitura, e um painel de status informa JSON válido ou o erro exato de análise para que você possa corrigir a origem.
Por que formatar JSON com esta ferramenta?
- Privacidade: cada operação de análise, formatação e minificação acontece no seu navegador. O JSON nunca chega aos nossos servidores.
- Validação imediata: vírgulas mal colocadas, chaves sem aspas, aspas simples e vírgulas finais são relatadas com uma indicação precisa de linha e coluna, para que você possa ir direto ao bug.
- Saída pronta para revisão: JSON impresso com indentação consistente gera diffs limpos em revisões de código e arquivos de configuração legíveis.
- Minificação pronta para produção: remover espaços em branco supérfluos reduz cargas de API, arquivos de manifesto e fixtures embutidas antes de publicá-los.
Quais são as aplicações comuns da formatação JSON?
Ler e escrever JSON aparece em vários contextos de desenvolvimento web e ferramentas:
- Depuração de APIs: colar uma resposta bruta do
curlou do painel de rede para confirmar o formato, encontrar um erro de digitação em uma chave ou identificar uma chave de fechamento ausente. - Limpeza de configurações: reindentar arquivos editados à mão como
package.json,tsconfig.jsonou manifestos de CI para que passem nas revisões e linters. - Leitura de logs: reformatar linhas compactas de log
application/jsonpara que cada campo fique alinhado sob o próximo, e em seguida minificar novamente antes de colar em um ticket.
Como é um exemplo de formatação JSON?
Ao colar {"id":42,"name":"Ada Lovelace","email":"ada@example.com","roles":["admin","engineer"]} e pressionar FORMATAR com indentação de 2 espaços, o texto se expande em nove linhas, com cada campo do objeto e cada item do array em sua própria linha. Ao pressionar MINIFICAR sobre o texto formatado, ele volta à mesma string compacta, byte a byte.
Este formatador JSON analisa com o mesmo motor que o seu runtime Node.js, Deno ou navegador utiliza e gera uma saída que você pode colar diretamente em código, configurações ou logs.