IA no seu dispositivo — profissional e privado.

Documentos

Como validar JSON online (e o que significa cada mensagem de erro)

Valide JSON online e entenda o erro: vírgulas finais, aspas simples, chaves sem aspas, comentários, BOM, chaves duplicadas e números longos, com a correção.

Atualizado em 8 de novembro de 202610 min de leitura

Para validar JSON, cole o conteúdo no validador JSON ou solte o arquivo .json nele e clique em Validar. Um JSON válido recebe um resultado verde com o tipo raiz e a estrutura. Um JSON inválido recebe um resultado vermelho e a lista de todos os erros de uma vez, cada um com linha, coluna e um acento circunflexo (^) sob o caractere exato. O difícil quase nunca é descobrir que algo está errado, e sim entender a mensagem, porque cada programa escreve de um jeito. Este guia explica o que as mensagens comuns significam, quais "erros" são na verdade outro dialeto de JSON, por que um arquivo perfeito falha na posição 0 e quais são os dois problemas que passam por qualquer parser sem dar sinal.

Como validar JSON online, passo a passo

1

Cole o JSON ou adicione o arquivo

Abra o validador JSON e cole o texto no editor, ou solte um arquivo. Ele aceita .json, .jsonc, .json5, .ndjson, .jsonl, .geojson, .webmanifest, .har, .map e .txt. JSON minificado e JSON indentado funcionam do mesmo jeito.

2

Deixe o tipo de documento em Automático

Automático lê o texto como um único documento JSON. Se ele parecer ter um registro por linha, a ferramenta oferece verificar como NDJSON, em vez de mudar sozinha.

3

Clique em Validar

Se passar, você vê o tipo raiz (objeto, array etc.), o número de chaves ou itens e um relatório de estrutura: nós, profundidade máxima, objetos, arrays, chaves, linhas, tamanho e a codificação lida. Se falhar, cada erro aparece com Ln e coluna; clique em Ir para levar o cursor até ele.

4

Leia também os avisos

Chaves duplicadas e números que perdem precisão aparecem como avisos. Eles não mudam o resultado, porque qualquer parser os aceita, mas é aí que os dados somem sem aviso.

5

Corrija à mão ou use a cópia reparada

Se os únicos problemas forem comentários, vírgulas finais, aspas simples e coisas do tipo, uma cópia reparada em JSON estrito é oferecida. Clique em Usar o JSON reparado para carregá-la no editor, ou em Baixar .json reparado.

O que as mensagens de erro de JSON realmente significam

Cada linguagem e cada aplicativo escreve do seu jeito o mesmo punhado de falhas, e a posição informada é onde o parser desistiu, muitas vezes um caractere depois do seu erro. Esta tabela traduz as mensagens típicas em inglês que você encontra em outros lugares para a causa e para a mensagem que o validador mostra.

Mensagem típica em outros programasO que costuma significarO que o validador diz
"Expected double-quoted property name" ou "Expecting property name enclosed in double quotes"Uma vírgula final antes de }, uma chave com aspas simples ou sem aspasUma vírgula final antes do fechamento; ou: a chave não está entre aspas
"Unexpected token" ou "Expecting value"Algo que não é um valor JSON: um comentário, NaN, undefined, True ou um caractere soltoO JSON não aceita comentários; ou: isto não é um valor JSON
"Expecting ',' delimiter"Dois membros ou itens sem vírgula entre elesFalta uma vírgula antes deste valor
"Unexpected end of JSON input"Uma chave ou um colchete que nunca foi fechado, ou um texto cortadoUm objeto (ou array) é aberto e nunca fechado
"Unterminated string" ou "Bad control character in string literal"Falta a aspa de fechamento, ou há uma quebra de linha ou tabulação real dentro de uma stringEsta string nunca é fechada; ou: um caractere de controle precisa de escape
"Unexpected non-whitespace character after JSON" ou "Extra data"Dois documentos colados juntos, ou um registro por linhaO valor JSON termina antes disto; tudo a partir daqui está sobrando
"Unexpected token" na posição 0 ou "Unexpected UTF-8 BOM"Bytes invisíveis antes da primeira chave, ou um arquivo que nem é JSONA marca é removida e a codificação é informada

A "posição" dessas mensagens conta caracteres a partir de zero: a posição 0 é o primeiro caractere e a posição 7 é o oitavo. Linhas e colunas contam a partir de um. O validador mostra tudo isso, além de um deslocamento em bytes para scripts, e calcula esses valores por conta própria, então o local é o mesmo em qualquer navegador.

Todos os erros de uma vez com linha, coluna e marcador, além de chaves duplicadas, avisos de precisão, JSON Schema e reparo. Grátis: texto colado ou um arquivo de até 25 MB, com todas as verificações incluídas. Pro: até 100 arquivos de uma vez e relatórios legíveis por máquina em JSON e CSV. Tudo roda no seu dispositivo, não nos nossos servidores.

Validar JSON

Vírgulas finais, aspas simples, chaves sem aspas, comentários: quebrado ou um dialeto?

Muitos arquivos apontados como JSON inválido não estão danificados. Eles foram escritos em um dialeto mais flexível, que o seu editor lê sem problema e que um parser estrito recusa. Saber qual é o seu caso diz se você precisa corrigir o arquivo ou o programa que o lê.

  • JSONC (JSON com comentários) adiciona comentários com // e /* */ e vírgulas finais. tsconfig.json, .eslintrc e a maioria dos arquivos de configuração de editores são JSONC. Funcionam no editor e falham em um processo que espera JSON puro.
  • JSON5 também permite chaves sem aspas, strings com aspas simples, números hexadecimais, sinal de mais ou ponto decimal no início, além de NaN e Infinity.
  • Um dicionário Python impresso por um script parece JSON, mas usa True, False e None, e muitas vezes aspas simples.
  • Texto vindo de um editor de texto pode ter aspas tipográficas (“ ”) no lugar das aspas retas. Elas parecem certas e não são JSON.

Quando o texto é um desses casos, o validador diz isso com todas as letras (por exemplo, que é JSONC e não JSON quebrado) e lista as construções responsáveis. O reparo parte do que o analisador encontrou, então um // dentro de uma URL ou uma vírgula dentro de um valor entre aspas nunca é alterado. NaN e Infinity não têm escrita em JSON e viram null, e essa mudança é destacada. Se, além do dialeto, sobrarem erros de sintaxe reais, nenhuma cópia reparada é oferecida. Para deixar o resultado com uma indentação legível, veja como formatar JSON online.

Por que um arquivo perfeito falha na posição 0: BOM e UTF-16

Se um erro aponta a posição 0, linha 1, coluna 1, e o arquivo parece certo, desconfie dos bytes que você não vê. Uma marca de ordem de bytes UTF-8 (BOM) são três bytes, EF BB BF, que algumas ferramentas do Windows gravam antes do texto, entre elas o Out-File do PowerShell, o StreamWriter do .NET e a exportação UTF-8 do Excel. Um parser estrito vê um caractere inesperado antes da chave de abertura e rejeita um documento que, fora isso, está correto.

O UTF-16 é pior: o Windows PowerShell grava nele quando nenhuma codificação é informada e, lido como UTF-8, ele parece ter um byte NUL depois de cada caractere. O validador detecta os dois casos, valida o documento como se a marca não existisse e informa a codificação usada no relatório de estrutura. Para que outros programas leiam o arquivo, salve-o de novo como UTF-8 sem BOM; no PowerShell, passe uma codificação explícita para o comando que grava o arquivo. Um arquivo que nem é texto, como uma imagem renomeada para .json, é recusado com esse motivo, em vez de gerar um erro de sintaxe confuso.

Válido, mas errado: chaves duplicadas e números longos

Dois problemas não geram erro em nenhum parser, e é por isso que chegam à produção. O primeiro é a chave duplicada. O JSON permite a mesma chave duas vezes em um objeto, e o comportamento comum é ficar com o último valor e descartar o primeiro sem dizer nada: {"a": 1, "a": 2} vira, em silêncio, {"a": 2}. O validador aponta cada repetição dentro de um objeto com um JSON Pointer até ela, como /users/3/email. A mesma chave em dois objetos diferentes é normal e não é apontada.

O segundo é um número longo demais para ser guardado com exatidão. A maioria dos parsers lê números JSON como ponto flutuante de 64 bits, que só representa inteiros exatos até 9.007.199.254.740.991. 12345678901234567890 volta como 12345678901234567000, sem nenhum erro. IDs de banco de dados, números de pedido e decimais longos são as vítimas típicas. O validador mostra o literal exato ao lado do valor que um parser vai produzir; 1e400, que estoura para Infinity, também é sinalizado. A correção fica do lado de quem envia: mande esses valores como strings. As duas verificações vêm ativadas em Verificações extra e podem ser desligadas.

Verificar a estrutura com um JSON Schema

Sintaxe válida significa apenas que o texto pode ser lido. Se ele tem os campos que um programa espera é outra pergunta, e quem responde é um JSON Schema. Cole um schema na caixa JSON Schema das configurações e o documento também é verificado contra ele depois da sintaxe. Os drafts 2020-12 e draft-07 são suportados; o draft é lido de $schema ou, se o schema não declarar nenhum, é presumido e informado. Cada falha vem com um JSON Pointer e a linha, com mensagens como "Falta a propriedade obrigatória id" ou "Era esperado string, mas foi encontrado number".

Dois detalhes pegam muita gente. Um $ref que aponta para outro servidor é informado, mas não é baixado, para que o seu schema fique no seu dispositivo; inclua as definições no próprio schema. E "format": "email" é uma anotação, não uma regra, como os dois drafts definem, então um endereço errado passa, a não ser que você marque Tratar format como regra, não como nota. O documento precisa ser lido primeiro; um JSON com erros de sintaxe não é comparado com o schema.

Arquivos de log e um registro por linha

Logs, exportações de dados e envios em lote para APIs muitas vezes são NDJSON ou JSON Lines: um valor JSON por linha. Lido como um único documento, um arquivo assim falha com um só erro inútil sobre conteúdo sobrando no começo da linha 2. Mude Tipo de documento para NDJSON (ou aceite a sugestão) e cada linha é verificada como um registro próprio, e cada falha recebe o número do registro além da linha e da coluna. A quebra de linha final não conta como registro, finais de linha do Windows são tratados e uma linha em branco no meio é apontada, porque o formato não tem registros vazios. A validação com schema vale para um único documento, então não fica disponível no modo NDJSON.

Limites grátis e Pro

GrátisPro
EntradaTexto colado ou um arquivo de cada vezAté 100 arquivos de uma vez
TamanhoAté 25 MBLimitado pelo seu dispositivo
VerificaçõesTodos os erros, avisos, JSON Schema, NDJSON, reparoAs mesmas
RelatórioRelatório em texto para copiar ou baixarTambém relatórios em JSON e CSV, e um ZIP para um lote

Tudo o que decide se um documento é válido é grátis. Se um arquivo passar do limite e você só precisar de uma parte, o visualizador JSON permite percorrer a estrutura. Se os seus dados começaram como YAML ou CSV, converta antes com YAML para JSON ou CSV para JSON. Se cada aspa tiver uma barra invertida antes, o JSON foi guardado dentro de uma string; remova o escape e depois valide.

Perguntas frequentes

Como verifico se um arquivo JSON é válido?

Cole o texto ou solte o arquivo no validador JSON e clique em Validar. "JSON válido" em verde significa que ele segue o padrão JSON (RFC 8259); "JSON inválido" em vermelho lista cada erro com linha e coluna.

Por que meu JSON diz "unexpected token" na posição 0?

Em geral o arquivo começa com uma BOM UTF-8 ou foi salvo em UTF-16, então o parser encontra um caractere invisível antes da primeira chave. Salve como UTF-8 sem BOM. Com menos frequência, o arquivo nem é JSON, como uma página de erro HTML salva como .json.

Vírgulas finais são permitidas em JSON?

Não. O JSON padrão não permite vírgula antes de } ou ]. JSONC e JSON5 permitem, e por isso o mesmo arquivo funciona no editor e falha em outro lugar. Apague a vírgula ou use a cópia reparada que o validador oferece.

JSON pode ter comentários?

Não no JSON padrão. Arquivos com comentários // ou /* */ são JSONC. O validador identifica o dialeto e pode entregar uma cópia estrita sem os comentários; um // dentro de uma string, como uma URL, fica intacto.

Por que meu JSON é válido, mas faltam dados?

Confira os avisos. Uma chave que aparece duas vezes em um objeto fica só com o último valor, e um número acima de 9.007.199.254.740.991 é arredondado na leitura. Nenhum dos dois gera erro, e o validador aponta os dois.

É seguro validar JSON privado aqui?

Sim. A verificação roda no seu dispositivo, não nos nossos servidores, então respostas de API, tokens e arquivos de configuração não são enviados. Depois que a página carrega, ela continua funcionando sem conexão de rede.

Continue lendo

Mais sobre Documentos →