Validação JSON é o processo de verificar se uma string de texto está em conformidade com a especificação JSON. Um documento JSON válido tem sintaxe correta: strings entre aspas duplas, sem vírgulas no final, sem comentários e um único elemento raiz. A validação informa imediatamente se seu JSON pode ser analisado — e, se não puder, exatamente onde está o problema.
JSON inválido quebra silenciosamente APIs, carregadores de configuração e pipelines de dados. Uma única vírgula mal colocada pode impedir que uma aplicação inteira inicie. Detectar esses erros em tempo de desenvolvimento — não em produção — é a diferença entre um lançamento tranquilo e uma interrupção.
📍
Localização exata do erro
O validador não apenas informa que o JSON é inválido, mas identifica a linha e coluna exatas onde o erro ocorre, para que você vá direto ao problema.
⚡
Validar enquanto digita
A validação em tempo real fornece feedback instantâneo enquanto você edita. Você vê os erros desaparecerem conforme os corrige — sem precisar clicar em um botão.
🔍
Distinguir sintaxe de lógica
A validação JSON captura apenas erros de sintaxe. Ela confirma que o documento é parseável, separado de se os valores são semanticamente corretos para sua aplicação.
🔒
Privado por design
Toda a validação é executada no seu navegador. Credenciais, chaves de API e payloads sensíveis nunca são enviados a um servidor.
Erros comuns de validação JSON
Esses quatro erros representam a grande maioria das falhas de validação JSON:
Vírgula no final
Uma vírgula após o último item em um objeto ou array. Válida em JavaScript, mas estritamente proibida em JSON.
json
{ "a": 1, "b": 2, }
Strings com aspas simples
Aspas simples não são válidas em JSON. Tanto chaves quanto valores devem usar aspas duplas.
json
{ 'key': 'value' }
Undefined e NaN
undefined, NaN e Infinity são valores do JavaScript, mas não são JSON válido. Use null ou uma string numérica no lugar.
json
{ "val": undefined }
Chaves sem aspas
JSON exige que todas as chaves de objetos sejam strings entre aspas duplas. Identificadores sem aspas, como em objetos JavaScript, não são permitidos.
json
{ key: "value" }
Casos de uso comuns
Verificação de contratos de API
Valide corpos de requisição e resposta com as formas esperadas para detectar bugs de integração antes de chegarem à produção.
QA de arquivos de configuração
Valide package.json, tsconfig.json e outros arquivos de configuração antes de fazer commit para garantir que sejam analisados corretamente.
Validação de pipeline de dados
Verifique se os dados ingeridos de fontes externas ou uploads de usuários são sintaticamente corretos antes do processamento.
Verificação prévia em CI/CD
Execute a validação JSON como etapa de build para evitar que arquivos de configuração inválidos sejam implantados.
Aprendizado e depuração
Use o validador como ferramenta de aprendizado para entender por que padrões específicos de sintaxe JSON são ou não válidos.
QA de JSON gerado
Verifique se o JSON produzido por geradores de código, templates ou serializadores está corretamente formado antes do uso.
Perguntas frequentes
Qual é a diferença entre validação JSON e validação de JSON Schema?
A validação JSON (o que esta ferramenta faz) verifica a sintaxe — se o documento é JSON parseável. A validação de JSON Schema é uma etapa separada que verifica se os valores estão em conformidade com uma estrutura, tipos e restrições definidos.
JSON5 ou JSONC são JSON válido?
Não. JSON5 (permite aspas simples, comentários, vírgulas no final) e JSONC (permite comentários) são superconjuntos do JSON, mas não são JSON padrão válido. Esta ferramenta valida conforme a especificação JSON estrita (RFC 8259).
Por que meu JSON falha ao ser analisado mesmo parecendo correto?
Os culpados invisíveis mais comuns são: uma vírgula no final após a última propriedade, uma marca de ordem de bytes (BOM) no início do arquivo ou uma string com aspas simples. Cole seu JSON no validador para identificar o local exato.
JSON pode conter comentários?
Não — a especificação JSON (RFC 8259) proíbe explicitamente comentários. Se precisar de comentários em arquivos de configuração, use JSONC ou JSON5 localmente e remova os comentários antes de serializar.
Qual é um valor raiz JSON válido?
Qualquer valor JSON pode ser a raiz: um objeto {}, um array [], uma string, um número, true, false ou null. Na prática, a maioria das APIs usa um objeto ou array na raiz, mas todos os seis tipos são sintaticamente válidos.