Entrada

Saída

O que é um formatador JSON?

JSON (JavaScript Object Notation) é o formato de troca de dados mais usado na web. APIs retornam em JSON, arquivos de configuração usam JSON, bancos de dados armazenam em JSON — e quando algo quebra ou parece errado, você precisa conseguir ler esses dados. A especificação JSON é intencionalmente minimalista, o que é ótimo para as máquinas mas genuinamente doloroso quando você está tentando depurar uma resposta de API com muitos níveis de aninhamento. Um formatador JSON resolve isso: ele adiciona indentação e quebras de linha ao JSON bruto ou minificado para que a estrutura fique imediatamente clara.

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 um editor de código integrado, 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 package.json ou tsconfig.json 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 MongoDB, 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

É seguro colar chaves de API reais ou dados sensíveis aqui?

Completamente seguro. Toda a formatação acontece no seu navegador usando JavaScript — nada é enviado a qualquer servidor. Você pode verificar isso abrindo a aba Rede do seu navegador enquanto usa a ferramenta. Sem necessidade de conta, sem registros.

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.

Por que eu precisaria minificar JSON?

JSON minificado tem todos os espaços em branco removidos — sem quebras de linha, sem espaços, só os dados brutos. Isso o torna menor para enviar pela rede, mais barato para armazenar em um campo de banco de dados e seguro para incorporar em uma URL. O botão Minificar faz isso instantaneamente na saída atual. Há também uma página dedicada de Minificador JSON se esse for o seu principal caso de uso.

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.