Question 1

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

Accepted Answer

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.

Question 2

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

Accepted Answer

Não. A RFC 8259 não prevê comentários nem vírgula final, e JSON.parse rejeita os dois. Arquivos como tsconfig.json e as configurações do VS Code usam JSONC, uma variação que aceita comentários e vírgula final, e o JSON5 vai além. Se você colar um desses formatos, o modo Reparar remove os comentários e as vírgulas sobrando e lista cada remoção, para você decidir se quer aplicar.

Question 3

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

Accepted Answer

Não, o JSON só aceita aspas duplas. O print de um dict do Python usa aspas simples e escreve True, False e None, que no JSON são true, false e null. O modo Reparar converte as aspas e esses três valores. Para dados que vão de Python para outro sistema, prefira json.dumps, que gera JSON de verdade.

Question 4

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

Accepted Answer

Ele conserta o que tem leitura óbvia: vírgulas, aspas simples e curvas, chaves sem aspas, comentários, True/False/None, NaN e Infinity (viram null), números como .5 ou +1, hexadecimal, cercas de Markdown e colchetes ou strings que ficaram abertos por truncamento. Números com zero à esquerda, como 007, viram string para não perder os zeros. Vários documentos colados em sequência viram um array. Ele adivinha a intenção e pode errar em casos ambíguos, por isso mostra a lista de alterações antes de você aplicar. Erros sem leitura possível, como uma palavra solta no começo, não são reparados.

Question 5

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

Accepted Answer

A RFC 8259 recomenda nomes únicos e diz que o comportamento de quem recebe nomes repetidos é imprevisível. No JavaScript, JSON.parse mantém só o último valor e o resto some sem aviso, o que esconde bugs de configuração. Aqui a segunda ocorrência recebe um aviso com a linha da primeira, a saída mantém as duas e a consulta JSONPath usa a última, igual ao JavaScript.

Question 6

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

Accepted Answer

O JavaScript guarda números como double de 64 bits, que representa inteiros com exatidão só até 9007199254740991 (2^53 - 1). Acima disso, valores vizinhos viram o mesmo número: 9007199254740993 é lido como 9007199254740992. Decimais com mais de 15 a 17 dígitos significativos também são arredondados. O formatador avisa cada caso e preserva os dígitos no texto de saída. Para ids de 64 bits em APIs, o caminho seguro é trafegá-los como string.

Question 7

Ordenar as chaves ou minificar altera o significado do JSON?

Accepted Answer

Não. Objetos JSON são coleções sem ordem, então reordenar chaves não muda o dado, só facilita comparar dois arquivos. Os arrays mantêm a ordem dos itens. Minificar apenas remove espaços e quebras de linha fora das strings. Os números e os escapes das strings saem como estavam na entrada: \u00e9 continua \u00e9.

Question 8

Como validar um arquivo JSON Lines ou NDJSON?

Accepted Answer

Ative JSON Lines em Mais opções (ou abra um arquivo .jsonl ou .ndjson, que ativa sozinho). Cada linha é lida como um documento independente e o erro aponta a linha do arquivo inteiro, não da linha dentro do registro. A saída é um valor compacto por linha, que é o formato do JSON Lines (UTF-8, um valor por linha). Linhas em branco são ignoradas aqui, embora o formato não as permita. Já a Árvore e a Consulta tratam o arquivo como um array de registros.

Question 9

Qual sintaxe de consulta é suportada?

Accepted Answer

Um subconjunto de JSONPath inspirado na RFC 9535 (2024): $ para a raiz, .nome e ['nome'], índices e índices negativos como [-1], curinga [*] e .*, união [0,2], fatias [1:3] e [::2], descida recursiva ..nome e ..[*], e um filtro simples como [?(@.preco < 10)], [?(@.isbn)] ou [?(!@.isbn)] com ==, !=, <, <=, > e >=. Não há && e || nos filtros nem funções. Uma consulta fora do suporte mostra o erro e a posição, nunca um resultado vazio disfarçado. Cada resultado vem com seu caminho normalizado, e o limite é de 5 mil resultados.

Question 10

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

Accepted Answer

Não. A leitura, a formatação, a árvore e a consulta rodam no seu navegador, em um Web Worker, uma thread separada que mantém a página responsiva. Em um teste interno com 6,6 MB e 40 mil registros, a leitura levou cerca de 0,4 segundo e a formatação com ordenação de chaves cerca de 0,4 segundo, medido no Node. O upload aceita até 10 MB, a árvore mostra os filhos de 100 em 100 e a profundidade máxima aceita é de 1000 níveis.

Formatador e Validador de JSON