Um formatador JSON que informa o que está errado
Este formatador JSON gratuito transforma uma parede de dados minificados em JSON legível e indentado, além de verificá-lo ao mesmo tempo. Cole uma resposta de API, um arquivo de configuração ou uma linha de log e você terá três recursos de uma só vez: um validador JSON que aponta a linha e a coluna exatas do primeiro erro, um embelezador de JSON com indentação de 2 espaços, 4 espaços ou tabulação e um minificador para quando você precisar voltar à versão compacta. Visualização em árvore, ordenação de chaves, validação com JSON Schema e conversão de JSON para CSV estão a um clique de distância.
Tudo é executado no seu navegador. A ferramenta usa seu próprio pequeno analisador em vez de enviar seus dados para um servidor, por isso consegue explicar os erros em linguagem simples e os dados privados, como tokens, registros de clientes ou configurações internas, nunca saem da sua máquina.
Como ler uma mensagem de erro do JSON
A maioria dos erros de JSON não ocorre onde o analisador para, mas logo antes disso. Quando o validador informa Linha 3, coluna 9: Vírgula final antes de "}", ele mostra a linha com um acento circunflexo sob o caractere problemático, para que você veja a vírgula que não deveria estar ali. Alguns padrões abrangem a maioria dos casos do mundo real:
-
Vírgula final. O JavaScript permite
[1, 2,]; o JSON não. Remova a última vírgula. -
Aspas simples ou chaves sem aspas.
{name: 'Ann'}é um objeto JavaScript, não JSON. Chaves e strings precisam de aspas duplas:{"name": "Ann"}. -
Comentários. O JSON não tem comentários. Arquivos como tsconfig.json os aceitam porque suas ferramentas usam um formato mais flexível, mas um analisador JSON estrito rejeita
//e/* */. -
Vírgula ou colchete ausente. Se o erro aparecer no início de uma propriedade, verifique o final da linha acima. Se o erro for "fim inesperado da entrada", falta algum
}ou]de fechamento. -
Valores de Python ou JavaScript.
True,None,NaNeundefinednão são JSON. Usetrue,nullou um número. -
Aspas curvas. Textos copiados de um processador de texto ou aplicativo de chat geralmente contêm aspas tipográficas que parecem quase iguais a
".
O botão "Corrigir erros comuns" corrige comentários, aspas simples, chaves sem aspas, vírgulas finais, aspas curvas e valores no estilo Python em uma única etapa e lista o que foi alterado, para que você possa revisar o resultado em vez de confiar cegamente nele.
Números grandes e chaves duplicadas
O JSON em si não impõe limite de tamanho para números, mas o JavaScript os armazena como números de ponto flutuante de 64 bits. Um ID como 12345678901234567890 torna-se 12345678901234567000 depois de um normal JSON.parse. Este formatador mantém cada número exatamente como você o escreveu e avisa quando um valor é maior que 2^53, o que indica que ele deveria ser transmitido como string. Ele também sinaliza chaves duplicadas: o padrão JSON não as proíbe, mas a maioria dos analisadores mantém silenciosamente apenas a última, ocultando bugs.
Validação de JSON Schema em poucas palavras
Um validador JSON verifica a sintaxe. O JSON Schema verifica o significado: quais campos são obrigatórios, qual é o tipo de cada um e quais valores são permitidos. Um esquema pequeno se parece com isto:
{"type": "object", "required": ["id", "email"],
"properties": {"id": {"type": "integer", "minimum": 1},
"email": {"type": "string", "format": "email"}}}
A aba JSON Schema é compatível com o núcleo do draft 2020-12: tipos, enum e const, limites para números e strings, pattern, formatos comuns (email, date, date-time, uri, uuid, ipv4, hostname), properties, required, additionalProperties, patternProperties, items e prefixItems, uniqueItems, contains, allOf, anyOf, oneOf, not, if/then/else e local $ref links para $defs. Cada erro mostra o caminho da instância, como $.users[1].email, e o caminho do esquema que falhou. Palavras-chave que a ferramenta não avalia, como unevaluatedProperties, são listadas em vez de serem ignoradas silenciosamente. Se você ainda não tem um esquema, gere um primeiro rascunho a partir de um documento de exemplo e torne-o mais rigoroso manualmente.
Escrever esquemas para uma API inteira é um trabalho maior. Se você também precisa de dados estruturados em páginas da web, o validador de marcação de esquema verifica JSON-LD para mecanismos de busca, o que é um tipo diferente de esquema.
Converter JSON para CSV e vice-versa
As planilhas precisam de linhas e colunas. O conversor recebe um array de objetos, usa a união de todas as chaves como cabeçalho, transforma objetos aninhados em colunas na notação.por.pontos e mantém arrays como texto JSON em uma única célula. Valores que começam com =, + ou @ recebem um apóstrofo inicial para que a planilha não os execute como fórmulas. Na outra direção, cole um CSV com uma linha de cabeçalho: o delimitador é detectado, campos entre aspas com vírgulas e quebras de linha são tratados, números e true/false podem ser tipados, e cabeçalhos como address.city voltam a se tornar objetos aninhados. Para escrever as consultas que produzem esses dados, experimente o construtor de consultas SQL ou o gerador de fórmulas do Excel.
Dicas para trabalhar com JSON todos os dias
- Valide antes de depurar. Metade dos chamados de que "a API está com problema" é causada por uma vírgula ausente no corpo da requisição.
- Ordene as chaves antes de comparar dois documentos. Assim, as ferramentas de comparação mostram mudanças reais em vez de campos reordenados.
- Minifique para transportar e formate para as pessoas. Espaços em branco não têm significado no JSON, portanto as duas versões contêm os mesmos dados.
- Não coloque dados secretos em formatadores compartilhados. Ferramentas online que enviam seus dados representam um risco para tokens e dados pessoais; esta não envia nada.
Mais ferramentas gratuitas para desenvolvedores e equipes estão disponíveis na página de geradores e ferramentas gratuitas de AI, incluindo um gerador de casos de teste para o código que consome seu JSON.
Perguntas frequentes
Este formatador de JSON é gratuito e privado?
Sim. É gratuito, não exige cadastro e não tem limite. A formatação, a validação e a conversão são executadas no seu navegador com JavaScript puro, portanto seu JSON nunca é enviado, registrado ou armazenado em um servidor.
Qual é a diferença entre um formatador de JSON e um validador de JSON?
Um formatador (ou embelezador) adiciona indentação e quebras de linha para facilitar a leitura do JSON. Um validador verifica se o texto segue as regras do JSON e informa o primeiro erro. Esta ferramenta faz as duas coisas ao mesmo tempo e mostra a linha e a coluna exatas de qualquer erro.
Por que meu JSON falha com uma vírgula à direita ou aspas simples?
O JSON é mais rigoroso que o JavaScript. Ele não permite vírgula após o último item, strings entre aspas simples, chaves sem aspas ou comentários. Use o botão Corrigir erros comuns para reparar isso automaticamente e depois revise as alterações.
O formatador altera meus números ou a ordem das chaves?
Não. Os números são mantidos exatamente como foram escritos, mesmo IDs maiores do que o JavaScript consegue armazenar, e as chaves mantêm a ordem original, a menos que você ative Ordenar chaves de A a Z.
Qual versão do JSON Schema é compatível?
A ferramenta valida o núcleo do JSON Schema draft 2020-12, incluindo tipos, required, properties, enum, limites de strings e números, formatos, items, prefixItems, allOf, anyOf, oneOf, not, if/then/else e $ref local. As palavras-chave que ela não avalia são listadas em vez de serem ignoradas silenciosamente.
