Verifique o seu JSON em busca de erros e veja onde estão

Encontrar um erro em JSON é, na prática, descobrir o primeiro ponto em que o texto deixa de seguir as regras do formato. A ferramenta lê o documento do começo ao fim, caractere por caractere, como faz um parser real, e para assim que a gramática é quebrada. Nesse instante, ela informa a posição, muitas vezes em termos de linha e coluna ou índice do caractere, e explica o motivo: uma aspa que faltou, uma vírgula a mais, um valor inesperado. Reportar apenas o primeiro erro não é uma limitação, é como os parsers funcionam de verdade. Depois que ele para, tudo o que vem a seguir passa a ser interpretado fora de contexto, então de nada adiantaria listar erros derivados que talvez nem existam após a correção.

Os erros mais comuns que aparecem nessa verificação seguem alguns padrões bem conhecidos. As vírgulas finais, deixadas depois do último item de um objeto ou array, são talvez as campeãs. Logo atrás vêm as aspas simples no lugar das duplas e as chaves escritas sem aspas, heranças típicas de quem copiou um objeto de código JavaScript. Chaves e colchetes que não fecham, ou que fecham na ordem errada, geram o famoso fim inesperado do JSON. Há ainda strings que não são fechadas, valores proibidos como undefined e NaN, números mal escritos com zero à esquerda, e caracteres de controle não escapados dentro de strings. A ferramenta identifica em qual dessas situações o documento caiu e mostra a posição, poupando você de ler tudo à procura do defeito.

A grande vantagem de saber a posição exata é transformar uma busca no escuro em uma correção pontual. Em um arquivo com centenas de linhas, procurar uma vírgula a mais lendo tudo manualmente é lento e propenso a falhas. Com a posição indicada, você vai direto ao trecho e resolve. Vale lembrar que a causa real às vezes está um pouco antes do ponto marcado: quando falta uma vírgula entre dois itens, por exemplo, o parser só percebe o problema ao chegar no item seguinte, então a posição aponta para lá, mas o ajuste é na linha anterior. Por isso, ao chegar no local indicado, olhe também as linhas imediatamente acima. Depois de corrigir, verifique novamente para confirmar que o documento inteiro passou a ser válido.

Toda a verificação é feita localmente, no seu próprio navegador, sem que o JSON saia do computador. O documento não é enviado a nenhum servidor, não fica gravado em lugar algum e não trafega pela internet. Na prática, isso significa que você pode investigar erros em respostas de API que contenham tokens de autenticação, em exportações com dados de clientes ou em configurações internas sem expor nada disso. Como não há upload, também não há espera pela rede: mesmo documentos grandes são analisados em um instante, e você pode continuar trabalhando com a página aberta mesmo sem conexão. Não é preciso instalar programa, adicionar extensão nem criar conta. Basta abrir a ferramenta em um navegador moderno, colar o JSON e começar a procurar o que está impedindo o parsing.

É justo esclarecer o que a ferramenta faz e o que não faz. Ela encontra o erro, mostra onde está e explica por que o documento é inválido, mas quem realiza a edição é você. Não há correção automática que reescreva o JSON, e isso é intencional: assim você tem certeza de que nenhum valor foi alterado sem o seu conhecimento e mantém total controle sobre o conteúdo. O caminho recomendado é objetivo: verifique, leia a posição e o motivo, corrija o trecho apontado diretamente na caixa e verifique de novo. Repita até a mensagem de erro dar lugar à confirmação de JSON válido. Esse ciclo curto costuma resolver rapidamente até documentos que pareciam irremediavelmente quebrados, porque cada correção esclarece o próximo ponto a tratar.