Formatador JSON
Introdução
Um formatador JSON é uma ferramenta essencial para quem trabalha com dados JSON — desenvolvedores, testadores de API, analistas de dados e redatores técnicos. O JSON bruto de APIs ou arquivos de configuração é frequentemente minimizado ou mal indentado, dificultando a leitura e depuração. O formatador JSON transforma instantaneamente a entrada JSON bagunçada em uma saída limpa e bem estruturada com indentação adequada e validação de sintaxe.
Ao contrário de ferramentas de linha de comando ou extensões de navegador que exigem instalação, o Formatador JSON da Toollect funciona inteiramente no seu navegador. Cada colagem é analisada instantaneamente, dando feedback imediato sobre a validade e estrutura do seu JSON. Como nenhum dado é enviado a servidores externos, oferece velocidade e privacidade.
Seja você depurando uma resposta de API REST, preparando arquivos de configuração para implantação, ou ensinando sintaxe JSON, esta ferramenta fornece a precisão e imediatismo que você precisa.
Como funciona
O formatador JSON é alimentado pelos métodos nativos JavaScript JSON.parse() e JSON.stringify(), o mesmo motor que processa JSON em todos os navegadores modernos e Node.js.
Análise
A ferramenta passa seu texto de entrada para JSON.parse(). Este método lê a string e tenta construir um objeto ou array JavaScript na memória. O analisador é rigoroso — segue exatamente a especificação ECMA-404 JSON e rejeita qualquer desvio da sintaxe JSON válida.
Validação
Se JSON.parse() for bem-sucedido, a entrada é JSON válido. Se falhar, o método lança um SyntaxError com uma mensagem descritiva. A ferramenta captura este erro e o exibe na área de status. Erros comuns:
- Unexpected token: Caractere extra, vírgula final ou chave não entre aspas
- Expected property name: Vírgula faltando entre propriedades ou aspas incorretas
- Unexpected end of input: String JSON truncada ou parênteses não fechados
Formatação
Para JSON válido, a ferramenta passa o objeto analisado para JSON.stringify() com o parâmetro space=2. Isso instrui:
- Re-serializar o objeto como uma string JSON
- Inserir quebras de linha após cada
{,},[,]e vírgula - Indentar cada nível de aninhamento com dois espaços
- Preservar os tipos de dados originais
Saída
O resultado formatado aparece na área de saída, exibido com uma fonte monoespaçada para melhor legibilidade. A saída é somente leitura, mas pode ser copiada para a área de transferência com um clique.
Uso
Usar o Formatador JSON da Toollect não requer configuração ou registro. Siga estes passos:
-
Abra a ferramenta — Abra a página do formatador JSON no seu navegador.
-
Cole o JSON — Copie texto JSON de qualquer fonte e cole com Ctrl+V (Cmd+V no Mac) na área de entrada.
-
Veja o resultado — Após colar, a ferramenta formata automaticamente e exibe o resultado imediatamente.
-
Verifique o status — Confira o indicador de status entre os campos:
- Uma mensagem verde confirma JSON válido
- Uma mensagem de erro vermelha mostra o problema de análise
-
Copie o resultado — Clique em "Copiar" para transferir o JSON formatado para a área de transferência.
-
Recomece — Clique em "Limpar" para esvaziar ambos os campos.
Tutorial
Cenário: Você está depurando uma resposta de API REST e precisa inspecionar a estrutura JSON.
-
Abra o Formatador JSON.
-
Copie a resposta JSON bruta:
{"status":"success","data":{"users":[{"id":1,"name":"Alice","email":"[email protected]","active":true},{"id":2,"name":"Bob","email":"[email protected]","active":false}],"total":2,"page":1},"timestamp":"2026-07-11T10:30:00Z"}
- Cole e formate automaticamente:
{
"status": "success",
"data": {
"users": [
{ "id": 1, "name": "Alice", "email": "[email protected]", "active": true },
{ "id": 2, "name": "Bob", "email": "[email protected]", "active": false }
],
"total": 2,
"page": 1
},
"timestamp": "2026-07-11T10:30:00Z"
}
- Teste JSON com erros:
{"status":"success","data":{"users":[{"id":1,"name":"Alice",}]}}
A ferramenta mostra: Invalid JSON: Expected property name or '}' at position...
- Copie e use — Clique em "Copiar".
Dicas
- Vírgulas finais: JSON não as permite após o último elemento
- Diagnóstico com aspas: Em caso de dúvida, cole no formatador
- Valide respostas de API: Mantenha a ferramenta aberta durante o desenvolvimento
- Caracteres BOM: Uma string aparentemente válida pode conter caracteres Unicode invisíveis
- Comparação antes/depois: Use a visualização lado a lado
- Combine com outras ferramentas: Copie a saída formatada para uma ferramenta diff
Alternativas
| Ferramenta / Método | Ideal para | Limitações |
|---|---|---|
| Toollect Formatador JSON | Formatação no navegador, privacidade | Primeiro carregamento requer internet |
| JSONLint | Validação JSON rápida | Apenas servidor, sem modo offline |
| VS Code integrado | Formatação no editor | Requer VS Code instalado |
| jq (linha de comando) | Processamento JSON programático | Apenas linha de comando |
Solução de problemas
| Problema | Causa | Solução |
|---|---|---|
| Erro "Unexpected token" | Vírgula extra ou chave não entre aspas | Verificar vírgulas finais; usar aspas duplas |
| Erro "Expected property name" | Vírgula faltando | Adicionar vírgulas entre pares chave-valor |
| Erro "Unexpected end of input" | JSON truncado | Verificar fechamento de todos os colchetes |
| Saída vazia após formatação | Campo de entrada vazio | Certificar-se de que texto JSON foi colado |
| Formatação lenta | Arquivo muito grande | Dividir JSON em partes menores |
Especificações técnicas
Desempenho
| Tamanho do texto | Tempo de processamento | Memória |
|---|---|---|
| 1 KB (API típica) | < 1 ms | < 1 MB |
| 100 KB (config grande) | < 5 ms | < 5 MB |
| 1 MB (exportação dados) | < 50 ms | < 50 MB |
Detalhes técnicos
- Motor de validação:
JSON.parse()nativo (especificação ECMAScript) - Motor de formatação:
JSON.stringify()nativo comspace=2 - Modelo de eventos: Entrada aciona formatação automática (300ms debounce)
- Compatibilidade: Chrome 80+, Firefox 75+, Safari 13+, Edge 80+, Samsung Internet 13+, Opera 67+
Privacidade
- Zero transferência de dados: todo processamento na memória do navegador
- Sem cookies, localStorage ou sessionStorage
- Sem scripts de análise ou rastreamento
- Utilizável offline após carregamento inicial
- Sem registro, login ou chaves de API
Recursos
- Formatação e embelezamento instantâneos de JSON com indentação automática
- Validação JSON em tempo real com mensagens de erro detalhadas
- Detecção de erros de sintaxe com localização automática
- Cópia com um clique do JSON formatado
- Limpeza com um clique da entrada e saída
- Funciona completamente no navegador — nenhum dado é enviado a servidores