O que significa formatar e validar JSON?
- Formatar (beautify/pretty print): transforma JSON minificado em um bloco legível, com indentação, quebras de linha e espaçamento adequado.
- Minificar: remove espaços desnecessários para reduzir tamanho em requisições ou payloads.
- Validar: verifica se o texto é JSON sintaticamente correto (chaves com aspas duplas, vírgulas corretas, tipos válidos, etc.) e retorna o erro com contexto quando é inválido.
Formatar e validar são operações diferentes, aunque aconteçam no mesmo instante. A formatação é cosmética e reversível; a validação é binária e decide se o documento existe para o parser. Quando um payload falha ao ser enviado para a API, a causa quase sempre é sintática: uma vírgula a mais, uma aspa simples no lugar de dupla ou uma chave sem aspas.
Por que fazer isso 100% no navegador?
Muitos validadores online exigem upload do conteúdo. Com processamento client-side, você:
- Preserva privacidade: tokens, chaves de API e dados pessoais nunca saem do seu dispositivo.
- Ganha velocidade: sem latência de rede para arquivos pequenos ou médios.
- Funciona offline: útil em conexões instáveis, ambientes restritos ou dentro de um container de CI.
- Evita vazamento acidental em logs de terceiros.
- Elimina o custo de armazenamento: ninguém guarda uma cópia dos seus segredos.
Esse modelo tem uma consequência importante: o comportamento é determinístico e reproduzível. O mesmo payload produz o mesmo resultado na sua máquina e no pipeline da equipe, sem depender de um serviço externo que pode ficar fora do ar ou mudar de comportamento.
Como validar JSON com JavaScript nativo
O jeito mais direto é usar JSON.parse. Ele lança SyntaxError com mensagem útil em caso de falha.
function isValidJson(text) {
try {
JSON.parse(text);
return { valid: true };
} catch (e) {
return { valid: false, error: e.message };
}
}Para formatar, parseie e depois use JSON.stringify(obj, null, 2) para 2 espaços (ou 4). Para minificar, use JSON.stringify(obj).
const parsed = JSON.parse(input);
const pretty = JSON.stringify(parsed, null, 2);
const minified = JSON.stringify(parsed);Vale notar que JSON.stringify percorre o objeto inteiro e reconstrói a string, o que significa que a formatação é normalizada: a ordem das chaves é preservada, mas o espaçamento original desaparece. Números como 1.0 podem virar 1, porque a notação não carrega informação em JSON.
Erros comuns ao validar JSON
- Usar aspas simples em vez de duplas em chaves/strings.
- Vírgula extra no final de array ou objeto.
- Chaves sem aspas.
- Uso de
undefined, comentários ouNaN(não válidos em JSON puro). - Quebra de linha não escapada dentro de uma string.
- Caracteres invisíveis copiados de um log ou de um terminal (BOM, tabs, non-breaking space).
- Aspas tipográficas (curvas) coladas de um documento ou de um chat.
Um validador que informa linha e coluna do erro economiza mais tempo do que um que apenas diz “JSON inválido”: em um payload minificado de uma única linha, a posição do caractere é a única informação útil para localizar o defeito.
Boas práticas
- Prefira indentação consistente (2 espaços) para facilitar diff.
- Valide antes de enviar para API ou salvar em config.
- Ao colar de logs, limpe caracteres invisíveis se necessário.
- Use ferramentas client-side ao lidar com dados sensíveis.
- Combine validação sintática com validação de schema (zod, valibot) para regras de negócio.
- Formate os fixtures do repositório: um arquivo minificado esconde campos faltantes em code review.
Usando a ferramenta JSON Formatter do StackPulse
Nossa ferramenta permite formatar, minificar e validar JSON em tempo real, 100% no navegador. Sem upload, com detecção de erros por linha e coluna e cópia com um clique. Acesse em JSON Formatter & Validator.
Depois de validar o payload, o próximo passo natural é transformá-lo em tipos TypeScript. O guia como converter JSON em TypeScript mostra como automatizar essa etapa e o que revisar manualmente.
Conclusão
Formatador e validador de JSON são ferramentas indispensáveis. Ao fazer tudo localmente, você garante privacidade, agilidade e tranquilidade ao trabalhar com qualquer payload — do arquivo de configuração local até a resposta de uma API em produção.