Formatador e Validador de JSON

Como utilizar

JSON (JavaScript Object Notation) é o formato de texto padrão para trocar dados estruturados entre APIs, ficheiros de configuração e aplicações — é construído a partir de objetos (pares chave-valor entre chavetas), arrays (listas ordenadas entre parênteses retos) e um conjunto de tipos de valor: strings, números, booleanos, null e objetos ou arrays aninhados. Porque é apenas texto, uma única vírgula em falta ou um carácter estranho torna todo o documento ilegível para um analisador. A formatação e a validação resolvem dois problemas diferentes: a formatação (pretty-printing) recua novamente o texto para que a sua estrutura seja óbvia para o olho humano, enquanto a validação verifica se o texto é realmente JSON sintaticamente correto antes de qualquer código tentar analisá-lo. Imagine um pequeno objeto que chega de uma API tudo numa única linha, emparelhando uma chave "user" com a string "ada", uma chave "active" com o booleano true e uma chave "roles" com o array ["admin", "editor"] — tudo comprimido sem espaços. Embelezá-lo com um recuo de 2 espaços coloca cada chave na sua própria linha recuada, uma abaixo da outra, para que as entradas "user", "active" e "roles", mais o array de roles aninhado, sejam todas fáceis de examinar à primeira vista. Minificar faz o oposto: remove cada espaço, tabulação e quebra de linha que o formato não requer, recolapsando a versão embelezada na string compacta original. Minificar não muda o significado dos dados — remove apenas espaços em branco que existem para legibilidade humana, razão pela qual é seguro minificar antes de enviar JSON pela rede, mas inútil minificar antes de ler você mesmo. A validação apanha os erros que são fáceis de cometer manualmente e fáceis de perder a olho: uma vírgula à direita após o último item num objeto ou array (válido em literais de objeto JavaScript, inválido em JSON), chaves de objeto escritas sem aspas, strings envolvidas em aspas simples em vez de aspas duplas, e um parêntese ou chaveta que foi aberto mas nunca fechado. A gramática JSON não tem tolerância para nenhum destes — ao contrário de JavaScript, que aceita sintaxe mais solta, um analisador JSON rejeita todo o documento no primeiro erro que encontra. Corrigir JSON inválido geralmente significa percorrer os erros de cima para baixo: adicionar aspas duplas em torno de chaves e valores de strings, remover a última vírgula antes de uma chaveta ou parêntese de fecho, e contar as suas chavetas para garantir que cada abertura tem um fecho. O tamanho da indentação é uma questão de convenção em vez de correção — 2 espaços é comum em JavaScript/TypeScript e ficheiros de configuração web porque mantém objetos profundamente aninhados mais estreitos, 4 espaços é mais comum em ferramentas adjacentes a Python e guias de estilo que priorizam a separação visual entre níveis, e tabulações permitem que cada editor do leitor processe a largura que prefere. Nenhum destes afeta a forma como o JSON é analisado; escolha o que corresponder ao ficheiro que está a editar ou à convenção que a sua equipa já utiliza. A formatação e a validação de JSON surgem constantemente: depuração de uma resposta de API que chegou minificada numa aba de rede, verificação de um ficheiro de configuração editado manualmente (como package.json ou tsconfig.json) antes de quebrar uma compilação, limpeza de JSON copiado de uma linha de registo ou mensagem de erro para que seja legível, e minificação de JSON antes de armazenar ou transmitir para poupar bytes de um payload — mesmo uma redução modesta acumula-se ao longo de milhões de pedidos.

Perguntas frequentes

O meu JSON é enviado para um servidor?

Não. A formatação, minificação e validação ocorrem todas no seu navegador — os seus dados nunca saem do seu dispositivo.

O que verifica o validador?

Analisa o seu texto como JSON rigoroso e relata o primeiro erro de sintaxe, incluindo a linha e a coluna onde foi encontrado quando o seu navegador o fornece.

Qual é a diferença entre embelezar e minificar?

Embelezar adiciona indentação e quebras de linha para tornar JSON legível; minificar remove todo o espaço em branco desnecessário para torná-lo o mais pequeno possível.

Como posso corrigir JSON inválido?

Leia a mensagem de erro primeiro — geralmente aponta para a linha e coluna onde a análise falhou. As causas mais comuns são uma vírgula à direita antes de uma chaveta ou parêntese de fecho, chaves de objeto ou valores de string envolvidos em aspas simples em vez de aspas duplas e um parêntese de fecho em falta. Corrija o primeiro erro, valide novamente e repita até o documento ser analisado corretamente.