Entrada

Saída

O que é um formatador JSON?

JSON (JavaScript Object Notation) é o formato de dados mais usado na web hoje. APIs retornam, arquivos de configuração usam, bancos de dados armazenam. A especificação JSON mantém tudo mínimo, ótimo para máquinas, mas não tanto quando você precisa ler os dados. Um formatador JSON adiciona indentação e quebras de linha ao JSON bruto ou minificado para que você veja a estrutura claramente.

Esta ferramenta roda inteiramente no seu navegador. Seu JSON passa por JSON.stringify() com indentação de 2 espaços, e o resultado aparece no painel de saída. Nada é enviado a um servidor, então é seguro usar com dados de produção, tokens ou qualquer coisa que você não queira que saia da sua máquina.

Exemplos de formatação JSON

Aqui estão alguns exemplos do que o formatador faz. JSON minificado ou compacto é difícil de ler; formatá-lo revela a estrutura de relance.

Exemplo 1: Registro de assinante

Entrada minificada (uma linha):

Entrada

Saída formatada:

Saída

Exemplo 2: Registros de chamadas

Entrada minificada:

Entrada

Saída formatada:

Saída

Clique no botão Amostra acima para carregar um exemplo pronto (dados de plano móvel) no editor e ver o formatador em ação.

Como usar esta ferramenta

1

Colar ou enviar

Copie seu JSON e cole no editor esquerdo. Você também pode clicar em Enviar para carregar um arquivo .json ou .txt do seu computador. O botão Amostra carrega dados de exemplo para testar.

2

Verificar a saída

O painel direito é atualizado automaticamente conforme você digita. JSON válido é formatado com indentação adequada conforme RFC 8259. Se houver erro de sintaxe (chave faltando, vírgula extra, chave sem aspas), você verá uma mensagem de erro.

3

Copiar, baixar ou minificar

Use Copiar para colocar o resultado na área de transferência, Baixar para salvar como arquivo, ou Minificar para remover espaços e obter uma versão compacta em uma linha.

Como o formatador funciona

Ambos os editores usam o Ace Editor, que fornece destaque de sintaxe, números de linha e marcadores de erro específicos para JSON. Quando você cola ou digita JSON no painel de entrada, a ferramenta espera 300 ms (para evitar parsing durante a digitação), depois executa JSON.parse() na sua entrada. Se o parsing tiver sucesso, chama JSON.stringify(data, null, 2) e exibe o resultado. Se falhar, a saída mostra um erro.

Vale notar: JSON não suporta comentários. Isso está definido na especificação em si, não é uma limitação desta ferramenta. Arquivos como settings.json do VS Code usam JSONC (JSON com comentários), um formato diferente. Se seu arquivo tiver comentários, remova-os antes de formatar.

Onde a formatação JSON ajuda

A maioria dos desenvolvedores precisa de um formatador ao ler respostas de API. Você envia uma requisição via Postman ou curl, e a resposta vem em uma linha comprimida. Colar aqui torna objetos e arrays aninhados visíveis imediatamente. Para extrair valores específicos de respostas grandes, jq funciona bem na linha de comando.

Arquivos de configuração são outro caso comum. Um <code>package.json</code> ou <code>tsconfig.json</code> com indentação inconsistente é difícil de revisar em um pull request. Formatá-lo aqui dá uma versão consistente para colar de volta. Para combinar dois arquivos de configuração, existe a ferramenta Mesclar JSON.

Exportações de banco de dados de <a href="https://www.mongodb.com/docs/manual/reference/mongodb-extended-json/" target="_blank" rel="noopener">MongoDB</a>, Firestore ou CouchDB são tipicamente grandes blocos JSON sem formatação. Passá-los por aqui ajuda a entender a estrutura do documento antes de escrever scripts de importação ou consultas. Se precisar dos dados em planilha, use JSON para CSV para converter.

Também é útil antes de compartilhar JSON com a equipe. JSON formatado em uma mensagem Slack ou ticket Jira é muito mais fácil de ler que uma string minificada. Passar primeiro pelo Validador JSON pode detectar problemas antes que outros vejam.

Perguntas frequentes

Meus dados são privados?

Sim. A formatação ocorre no seu navegador usando JavaScript. Nenhum dado é enviado a um servidor. Você pode confirmar abrindo a aba Rede do navegador enquanto usa a ferramenta.

Qual é o limite de tamanho?

Não há limite rígido da ferramenta. Depende da memória disponível do navegador. Arquivos JSON de até 10–15 MB geralmente funcionam sem problemas no Chrome e Firefox. Para arquivos muito grandes (centenas de MB), uma ferramenta de linha de comando como jq é mais prática.

O que Minificar faz?

Remove todos os espaços em branco (quebras de linha, espaços, indentação) da saída formatada, gerando a menor versão possível do JSON. Útil para incorporar JSON em URLs, armazenar em campos de banco de dados ou reduzir o tamanho do payload na rede. Também existe a página Minificador JSON.

Por que a saída diz "JSON inválido"?

A entrada tem um erro de sintaxe. Causas comuns incluem vírgula após o último elemento, aspas simples em vez de duplas, nomes de propriedades sem aspas ou chaves desbalanceadas. A especificação JSON é rigorosa com tudo isso.

Isso pode validar JSON contra um esquema?

Esta ferramenta valida a sintaxe (se o JSON está bem formado), não a estrutura. Para validação de esquema, use o Gerador de esquema JSON para gerar um esquema a partir de dados de exemplo, ou o Validador JSON para verificações mais detalhadas.

Ferramentas relacionadas

Para mais informações sobre JSON: guia MDN, RFC 8259, json.org e jq.