Verificador de sintaxe JSON com localização do erro

A base da sintaxe JSON são as aspas duplas. Toda chave de um objeto precisa estar entre aspas duplas e toda string também. Isso surpreende quem vem do JavaScript, onde é comum escrever chaves sem aspas ou usar aspas simples. Em JSON, um par como 'nome': 'Ana' é inválido; o correto é "nome": "Ana". As aspas simples não são reconhecidas em nenhuma posição, nem em chaves nem em valores. Dentro de uma string, caracteres especiais como aspas duplas, barra invertida e quebras de linha precisam ser escapados com barra invertida. O verificador confere cada abertura e fechamento de aspas e detecta quando uma string começa mas não termina, um erro que costuma deslocar toda a interpretação do restante do documento.

O segundo pilar são as vírgulas e a estrutura. Os itens de um objeto e os elementos de um array são separados por vírgula, mas essa vírgula é um separador, não um terminador. Ou seja, ela vai entre dois itens e nunca depois do último. Escrever [1, 2, 3,] ou um objeto terminado em vírgula deixa uma vírgula final que invalida o JSON, mesmo que muitos editores de código tolerem isso em outras linguagens. Além disso, dois pontos separam a chave do valor em cada par de objeto. O verificador acompanha a contagem de itens e sinaliza tanto a vírgula que sobra quanto a que falta entre dois elementos, indicando a posição onde a estrutura deixou de fazer sentido para o parser.

O terceiro pilar é o equilíbrio entre chaves e colchetes. Cada chave que abre um objeto precisa de uma chave que o feche, e cada colchete que abre um array precisa do colchete correspondente. Eles também têm de fechar na ordem certa, respeitando o aninhamento: um array dentro de um objeto fecha o colchete antes de fechar a chave externa. Um único símbolo esquecido faz o parser percorrer o resto do texto esperando um fechamento que nunca chega, o que costuma gerar a mensagem de fim inesperado do JSON. O verificador rastreia a pilha de aberturas e fechamentos e aponta onde o equilíbrio se rompeu, ajudando você a encontrar rapidamente o colchete ou a chave que ficou faltando ou sobrando.

Vale destacar o que a sintaxe do JSON não permite, porque são justamente essas tentativas que mais geram erros. Não existem comentários: nem os de duas barras, nem os de barra com asterisco, nem os de cerquilha. Os valores aceitos são apenas string, número, booleano true e false, null, objeto e array. Constantes de JavaScript como undefined, NaN e Infinity não são JSON válido. Números não podem ter zeros à esquerda nem começar por ponto. O verificador percorre o texto e para no primeiro ponto que viola qualquer dessas regras, mostrando a posição e o motivo. Como reproduz a mesma lógica de um parser real, o que ele aprova aqui será aceito pelo JSON.parse do seu código, sem diferenças entre o teste e a execução.

Todo esse trabalho de conferência é feito localmente, dentro do navegador. O seu JSON não sai do computador, não é enviado a um servidor nem fica armazenado, o que permite verificar trechos com dados internos sem preocupação. É importante ser honesto sobre o alcance da ferramenta: ela verifica, localiza e explica cada erro de sintaxe, mas quem faz a correção é você. Essa divisão é intencional, pois evita que um ajuste automático altere o conteúdo de forma indesejada. O fluxo natural é verificar, ler a posição do erro, corrigir na própria caixa e verificar de novo, repetindo até o documento passar limpo. Em arquivos longos, esse ciclo é muito mais rápido do que reler tudo procurando a aspa ou a vírgula problemática.