Pular para o conteúdo principal
Guia

Guia completo para formatação e validação de JSON

· 6 min de leitura

JSON (JavaScript Object Notation) se tornou o padrão de facto para troca de dados. Seja depurando uma API, analisando arquivos de configuração ou transmitindo dados, JSON está em toda parte.

Mas o JSON bruto é praticamente ilegível. Por isso ferramentas de formatação são essenciais.

Por que JSON é difícil de ler

APIs geralmente retornam JSON minificado:

{"name":"BoxrTools","tools":[{"slug":"json-formatter","category":"developer"},{"slug":"regex-tester","category":"developer"}],"stats":{"version":1,"free":true}}

Tecnicamente válido, mas você precisa contar chaves para encontrar um campo.

Uma vez formatado:

{
  "name": "BoxrTools",
  "tools": [
    { "slug": "json-formatter", "category": "developer" },
    { "slug": "regex-tester", "category": "developer" }
  ],
  "stats": { "version": 1, "free": true }
}

Mesmos dados, estrutura clara num piscar de olhos.

5 erros JSON comuns

1. Vírgula final

{ "a": 1, "b": 2, }  // ❌ erro de sintaxe

JSON não permite vírgula final.

2. Aspas simples

{ 'a': 1 }  // ❌

Apenas aspas duplas são aceitas.

3. Chaves sem aspas

{ a: 1 }  // ❌
{ "a": 1 }  // ✅

4. Serializar undefined

JSON.stringify({ a: undefined })  // → '{}'

undefined não existe em JSON.

5. Referências circulares

const a = {}; a.self = a;
JSON.stringify(a);  // ❌ lança erro

JSON não pode representar estruturas circulares.

Que indentação usar

  • 2 espaços — compacto, ideal para dados profundamente aninhados
  • 4 espaços — mais legível
  • Tab — preferência pessoal

Não há resposta certa. O importante é a consistência.

Validar ≠ formatar

Validar pergunta: “Isto é JSON válido?”. Formatar embeleza.

Boas ferramentas fazem os dois.

Experimente nossa ferramenta

Nosso formatador e validador JSON oferece:

  • Validação em tempo real + mensagens de erro com número de linha
  • 3 opções de indentação
  • Ordenar chaves alfabeticamente (opcional)
  • Minificar com um clique
  • 100 % no navegador — seus dados nunca saem do dispositivo