Formatador e Validador de JSON

Continuar na ferramenta

Mais páginas desta ferramenta

json vírgula final comentários

Vírgula no final e comentários em JSON: pode ou não pode?

Cole o arquivo com comentários ou vírgulas sobrando e ligue o reparo: cada comentário e cada vírgula final removidos aparecem em uma lista com linha e coluna, e você decide se aplica o resultado no editor.

O que a especificação diz e o que as ferramentas toleram

A gramática do JSON, na RFC 8259 e na ECMA-404, define vírgula apenas entre dois itens e não define nenhuma forma de comentário. Um texto com vírgula depois do último item, com // ou com /* */ não é JSON válido, e o JSON.parse lança um SyntaxError para os dois casos. Não existe flag nem opção para relaxar isso no parser nativo. Foi uma escolha deliberada de simplicidade: sem comentários o formato fica pequeno, sem ambiguidade e igual em todas as linguagens.
A confusão vem dos formatos vizinhos. JSONC, "JSON com comentários", é usado por arquivos como tsconfig.json e pelas configurações do VS Code, e aceita comentários e, nesses programas, vírgula final. JSON5 é mais permissivo ainda: aspas simples, chaves sem aspas, números hexadecimais e mais. Cada um desses formatos exige o seu próprio leitor, então um arquivo JSONC passado a um JSON.parse falha. O fluxo seguro é manter o JSONC na configuração local e, ao enviar para uma API ou outro sistema, converter para JSON estrito, que é exatamente o que o reparo faz.
O reparo remove comentários de linha, de bloco e iniciados por #, e remove toda vírgula final ou repetida, em qualquer nível de aninhamento. O texto dos comentários se perde, porque o JSON não tem onde guardá-lo; se ele importa, copie antes. Se você precisa manter anotações, uma saída comum é uma chave comum como "_comment" ou "__note", que é JSON válido, embora o consumidor passe a recebê-la como dado. A ordem dos itens e os números ficam como estavam: 1.50 continua 1.50 e não vira 1.5.

Exemplos de remoção

Array com vírgula final

Entrada: [1, 2, 3,]
Saída esperada: [1,2,3]

Vírgula final apontada na coluna 9.

Comentário de linha

Entrada: {"a": 1, // nota "b": 2}
Saída esperada: {"a":1,"b":2}

Comentário apontado na linha 1, coluna 10.

Comentário de bloco

Entrada: /* cfg */ {"debug": true}
Saída esperada: {"debug":true}

Comentário de bloco na coluna 1.

Três vírgulas finais aninhadas

Entrada: {"a": [1, 2,], "b": {"c": 3,},}
Saída esperada: {"a":[1,2],"b":{"c":3}}

Colunas 12, 28 e 30.

Estilo tsconfig.json

Entrada: {"compilerOptions": {"strict": true,},}
Saída esperada: {"compilerOptions":{"strict":true}}

Duas vírgulas finais, colunas 36 e 38.

FAQ da ferramenta completa

Por que meu JSON dá "Unexpected token" e onde está o erro?

As causas mais comuns são vírgula depois do último item, aspas simples, chave sem aspas, comentário e vírgula faltando entre dois valores. O JSON.parse informa só o primeiro problema e, em alguns navegadores, apenas a posição em caracteres. Este formatador lista todos os erros do texto, cada um com linha e coluna, mostra o trecho com uma seta sob o ponto exato, marca a linha na margem do editor e tem o botão Ir para o erro, que seleciona o trecho.

O JSON pode ter comentários ou vírgula no final?

Aspas simples funcionam em JSON? E o dict do Python?

O que o modo Reparar faz e quais são os limites?

O que acontece quando o JSON tem a mesma chave duas vezes?

Por que um número grande muda depois de passar pelo JavaScript?

Ordenar as chaves ou minificar altera o significado do JSON?

Como validar um arquivo JSON Lines ou NDJSON?

Qual sintaxe de consulta é suportada?

Meu JSON é enviado a algum servidor? E arquivos grandes?

Perguntas frequentes

Posso usar comentários em um arquivo .json?

Pelo padrão, não. Alguns programas leem .json como JSONC e toleram comentários, mas isso é uma extensão deles. Se o arquivo vai para JSON.parse, para uma API ou para outra linguagem, remova os comentários antes.

Vírgula final é aceita no JavaScript e não no JSON?

Isso mesmo. Em literais de objeto e de array do JavaScript a vírgula final é permitida há anos, e muita gente copia um literal para um arquivo de dados. O JSON.parse continua exigindo a gramática estrita.

O reparo apaga o conteúdo dos comentários?

Apaga, porque o JSON não tem lugar para eles. A lista de alterações mostra a linha e a coluna de cada comentário removido, e o seu texto original continua no editor até você aplicar o resultado.

Há como manter uma anotação dentro de um JSON válido?

A saída mais usada é uma chave de texto comum, como "_comment". É JSON válido, mas o sistema que lê o arquivo passa a ver essa chave como dado, então confirme que ele a ignora.

Próximos passos

O que a especificação diz e o que as ferramentas toleram

A gramática do JSON, na RFC 8259 e na ECMA-404, define vírgula apenas entre dois itens e não define nenhuma forma de comentário. Um texto com vírgula depois do último item, com // ou com /* */ não é JSON válido, e o JSON.parse lança um SyntaxError para os dois casos. Não existe flag nem opção para relaxar isso no parser nativo. Foi uma escolha deliberada de simplicidade: sem comentários o formato fica pequeno, sem ambiguidade e igual em todas as linguagens.

A confusão vem dos formatos vizinhos. JSONC, "JSON com comentários", é usado por arquivos como tsconfig.json e pelas configurações do VS Code, e aceita comentários e, nesses programas, vírgula final. JSON5 é mais permissivo ainda: aspas simples, chaves sem aspas, números hexadecimais e mais. Cada um desses formatos exige o seu próprio leitor, então um arquivo JSONC passado a um JSON.parse falha. O fluxo seguro é manter o JSONC na configuração local e, ao enviar para uma API ou outro sistema, converter para JSON estrito, que é exatamente o que o reparo faz.

O reparo remove comentários de linha, de bloco e iniciados por #, e remove toda vírgula final ou repetida, em qualquer nível de aninhamento. O texto dos comentários se perde, porque o JSON não tem onde guardá-lo; se ele importa, copie antes. Se você precisa manter anotações, uma saída comum é uma chave comum como "_comment" ou "__note", que é JSON válido, embora o consumidor passe a recebê-la como dado. A ordem dos itens e os números ficam como estavam: 1.50 continua 1.50 e não vira 1.5.

Exemplos de remoção

Array com vírgula final

Entrada: [1, 2, 3,]
Saída esperada: [1,2,3]

Vírgula final apontada na coluna 9.

Comentário de linha

Entrada: {"a": 1, // nota "b": 2}
Saída esperada: {"a":1,"b":2}

Comentário apontado na linha 1, coluna 10.

Comentário de bloco

Entrada: /* cfg */ {"debug": true}
Saída esperada: {"debug":true}

Comentário de bloco na coluna 1.

Três vírgulas finais aninhadas

Entrada: {"a": [1, 2,], "b": {"c": 3,},}
Saída esperada: {"a":[1,2],"b":{"c":3}}

Colunas 12, 28 e 30.

Estilo tsconfig.json

Entrada: {"compilerOptions": {"strict": true,},}
Saída esperada: {"compilerOptions":{"strict":true}}

Duas vírgulas finais, colunas 36 e 38.

FAQ da ferramenta completa

Por que meu JSON dá "Unexpected token" e onde está o erro?

O JSON pode ter comentários ou vírgula no final?

Aspas simples funcionam em JSON? E o dict do Python?

O que o modo Reparar faz e quais são os limites?

O que acontece quando o JSON tem a mesma chave duas vezes?

Por que um número grande muda depois de passar pelo JavaScript?

Ordenar as chaves ou minificar altera o significado do JSON?

Como validar um arquivo JSON Lines ou NDJSON?

Qual sintaxe de consulta é suportada?

Meu JSON é enviado a algum servidor? E arquivos grandes?

Perguntas frequentes

Posso usar comentários em um arquivo .json?

Vírgula final é aceita no JavaScript e não no JSON?

O reparo apaga o conteúdo dos comentários?

Há como manter uma anotação dentro de um JSON válido?

A saída mais usada é uma chave de texto comum, como "_comment". É JSON válido, mas o sistema que lê o arquivo passa a ver essa chave como dado, então confirme que ele a ignora.