Formatador e validador de JSON

Formatador e validador de JSON online

Cole um JSON ou abra um arquivo e veja-o em uma forma legível: indentado, um valor por linha. A mesma página verifica a sintaxe enquanto você digita e informa a linha e a coluna exatas de um erro. O resultado pode ser copiado ou baixado como arquivo, formatado ou minificado. Tudo acontece no seu navegador, então seus dados, chaves e tokens nunca são enviados.

O que um formatador de JSON faz

APIs e serviços web costumam enviar o JSON em uma única linha longa "minificada", sem espaços nem quebras de linha, para ocupar menos espaço. Um formatador de JSON (também chamado de JSON formatter ou pretty printer) transforma essa linha em uma árvore de níveis aninhados com indentação, para uma pessoa conseguir ler. O botão Minificar faz o oposto e remove todo o espaço em branco.

• Só o espaço em branco muda. Muitas ferramentas leem o JSON e o escrevem de novo, e isso altera os dados: números longos como 12345678901234567890 perdem dígitos, 1.0 vira 1, o texto em cirílico vira П... e as chaves mudam de ordem. Esta ferramenta copia cada número, texto e chave como você escreveu e só acrescenta ou remove espaços e quebras de linha.
• Abrir arquivo (ou soltar um arquivo na caixa) lê um arquivo .json do seu computador; Baixar salva o resultado, por exemplo config.min.json depois de Minificar.
• Indentação de 2 espaços, 4 espaços ou uma tabulação. Ordenar chaves ordena alfabeticamente as chaves de cada objeto; por padrão a ordem que você escreveu é mantida.
• Ela serve para o texto de respostas de API, configuração e arquivos de dados. A verificação em si é rápida (um arquivo de 12 MB é lido em uma fração de segundo), mas uma caixa de texto com muitos megabytes demora para ser desenhada: até 1 ou 2 MB parece instantâneo, cerca de 8 MB de resultado levam alguns segundos.

Como o validador encontra erros

O texto é lido pela própria ferramenta, segundo o padrão JSON (RFC 8259), por isso a mensagem é a mesma em todos os navegadores. Ela mostra a linha e a coluna, a própria linha com um indicador sob o erro e uma dica. O botão "Ir para o erro" seleciona o lugar no texto. Os erros mais comuns que ela reconhece:

• uma vírgula depois do último item ou propriedade (vírgula sobrando), ou uma vírgula faltando entre dois itens;
• aspas simples em vez de aspas duplas e nomes de propriedades sem aspas;
• comentários (//, /* */, #), que o JSON não tem;
• colchetes ou chaves faltando ou sobrando, com o lugar onde o que ficou aberto foi aberto;
• valores de outras linguagens: True, None, undefined, NaN, Infinity;
• números inválidos: 01, .5, +1, 1., 0x1F;
• uma quebra de linha dentro de um texto, uma sequência de escape desconhecida como \x e caracteres que só parecem certos: aspas tipográficas, espaço não separável, espaço de largura zero.

Uma chave que aparece duas vezes no mesmo objeto é JSON legal, mas quase sempre é um erro, por isso a ferramenta lista essas chaves como aviso. Uma marca de ordem de bytes no início do texto é ignorada.

JSON estrito, não JSON5 nem JSONC

O validador aceita exatamente o que o JSON permite. Comentários, vírgulas sobrando e aspas simples são erros, mesmo onde alguns programas os toleram. Por exemplo, o tsconfig.json é JSONC, que permite comentários e vírgulas sobrando, por isso o validador os aponta. Um arquivo JavaScript como astro.config.mjs ou vite.config.js é código, não JSON, e não pode ser verificado aqui; o package.json é JSON e pode.

JSON, XML e CSV em resumo

• JSON: objetos e listas aninhados, com os tipos texto, número, true/false e null. O formato usual de APIs web e de configuração. Sem comentários e sem atributos.
• XML: tags aninhadas com atributos e namespaces, validadas por esquemas XSD; mais verboso, comum em sistemas antigos, SOAP e documentos.
• CSV: uma tabela plana de texto com uma linha de cabeçalho; sem tipos e sem aninhamento, mas abre em uma planilha.

Esta página trabalha só com JSON: ela não converte entre esses formatos. Para verificar se um documento JSON tem a estrutura certa (campos obrigatórios, tipos, valores permitidos) use o validador de JSON Schema.

Limitações

• Um aninhamento mais profundo que 2000 níveis é indicado como erro.
• O texto inteiro fica na memória do navegador e é mostrado em uma caixa de texto, então arquivos muito grandes (mais de 10 MB) ficam lentos, principalmente no celular.
• Só o primeiro erro de sintaxe é mostrado: corrija-o e o próximo, se houver, aparece na hora.
• O resultado só está disponível para JSON válido: com um erro, a caixa da direita fica vazia e o lado esquerdo mostra o que corrigir.