Validar sintaxe JSON

O validador sempre retorna um resultado estruturado: uma entrada válida produz um indicador verdadeiro simples, enquanto uma entrada inválida produz falso junto com a mensagem do analisador e a posição, a linha e a coluna onde a análise parou. Essa resposta previsível é útil em editores, formulários de upload, verificações de implantação, suítes de testes e qualquer fluxo que precise explicar um documento JSON incorreto sem interromper a execução.

Verifique a sintaxe sem alterar o documento

Um validador de sintaxe deve responder a uma pergunta específica: um analisador compatível com o padrão consegue ler exatamente esta string? Esta ferramenta envia o texto fornecido diretamente ao analisador JSON da plataforma. Ela não remove espaços das extremidades, troca aspas, apaga comentários, insere vírgulas, reordena chaves nem reinterpreta valores. Essa cautela é importante ao testar configurações ou cargas de API, pois uma correção automática poderia esconder o defeito que ainda falhará em produção. Um resultado válido significa que a string completa foi aceita como um único valor JSON, incluindo objetos, arrays, strings, números, booleanos e null. Um resultado inválido mantém a falha na saída normal, em vez de transformá-la em exceção. Assim, você pode exibir a resposta imediatamente ou verificar o indicador de validade no código. Texto vazio, conteúdo adicional, comentários, strings com aspas simples, vírgulas finais e caracteres de controle sem escape continuam inválidos porque não fazem parte da sintaxe JSON.

Entenda o local do erro informado

Quando a análise falha, o resultado inclui um objeto de erro com uma mensagem e três coordenadas. A posição é um deslocamento de caracteres iniciado em zero a partir do começo da string JavaScript. Linha e coluna começam em um, o que facilita sua exibição em um editor ou aviso de validação. Cada quebra de linha aumenta a contagem de linhas e reinicia a coluna. O local mostra onde o analisador percebeu que não poderia continuar; o erro real pode estar logo antes. Por exemplo, a falta de uma vírgula entre duas propriedades costuma ser indicada na aspa inicial da segunda, pois é nesse ponto que o analisador descobre que a primeira não foi seguida corretamente. Um objeto ou array incompleto é indicado no fim do texto. A redação do analisador pode variar entre ambientes JavaScript; use os campos numéricos para navegação e apresente a mensagem às pessoas, em vez de comparar o texto inteiro como categoria permanente.

Use o resultado com segurança em formulários e verificações

Em um formulário no navegador, execute a validação antes de enviar uma configuração e mova o cursor para a posição retornada quando o resultado for falso. Em um fluxo de API, trate a resposta como dados: prossiga somente quando for válida; caso contrário, anexe linha, coluna e mensagem a um relatório de build, chamado de suporte ou upload recusado. JSON malformado é conteúdo esperado do usuário, por isso recebe um resultado normal com o indicador falso, e não uma falha de entrada inválida. A solicitação só é rejeitada quando o campo de texto obrigatório está ausente ou não é uma string, pois nesse caso não há fonte JSON para examinar. O algoritmo é determinístico e não utiliza rede, modelo, valor aleatório, relógio nem estado persistente. O tempo de execução cresce linearmente com o tamanho do documento na análise e no cálculo comum do local. O uso da API custa US$ 0,002 por solicitação, enquanto a versão no navegador realiza localmente a mesma verificação.