Utilia
Categorias ▾
Idioma: pt ▾

Formatador e validador de JSON

Formatador e validador de JSON gratuito que formata, minifica e verifica JSON no teu navegador, com os erros de sintaxe indicados por linha e coluna.

Como usar o formatador de JSON

  1. Cola o teu JSON na caixa de entrada.
  2. Escolhe a Indentação: 2 espaços, 4 espaços ou tabulação. Ativa Ordenar as chaves se quiseres as chaves dos objetos por ordem alfabética.
  3. Clica em Formatar (embelezar) para apresentar o JSON de forma legível, ou em Minificar para o comprimir numa única linha.
  4. Se o JSON for inválido, lê a mensagem de erro, que indica a linha e a coluna do problema, corrige-o e tenta de novo.
  5. Copia o resultado e usa-o no teu código, na documentação ou no teu cliente de API.

O que faz esta ferramenta

O JSON (JavaScript Object Notation) é o formato mais comum para trocar dados entre serviços web e para ficheiros de configuração. O JSON em bruto que vem de uma API é muitas vezes uma única linha densa, difícil de ler. Esta ferramenta torna-o legível, verifica se é válido e consegue voltar a compactá-lo quando precisas de uma versão curta.

  • Formatar (embelezar): acrescenta quebras de linha e uma indentação coerente, para que o aninhamento de objetos e listas seja fácil de seguir. Podes indentar com 2 espaços, 4 espaços ou tabulações, de acordo com o estilo do teu projeto.
  • Minificar: retira todos os espaços desnecessários para produzir o JSON válido mais pequeno possível, útil para payloads, para incluir no código ou para reduzir o tamanho de um ficheiro.
  • Validar: verifica se a tua entrada é JSON bem formado. Se não for, a ferramenta mostra o erro de sintaxe com a linha e a coluna, para o encontrares depressa.
  • Ordenar as chaves: reordena alfabeticamente as chaves de todos os objetos. Torna os objetos grandes mais fáceis de percorrer e facilita muito a comparação lado a lado de dois documentos JSON.

Erros comuns em JSON

Quando a validação falha, a causa é geralmente uma destas:

  • Vírgulas finais: {"a": 1,} não é JSON válido, embora muitas linguagens de programação o permitam.
  • Aspas simples: as strings e as chaves JSON têm de usar aspas duplas. {'nome': 'Ana'} é inválido.
  • Chaves sem aspas: {nome: "Ana"} é JavaScript válido, mas não é JSON válido.
  • Comentários: o JSON padrão não permite comentários // nem /* */.
  • Vírgulas ou parênteses em falta: uma vírgula esquecida entre dois elementos ou um } ou ] por fechar.
  • Valores especiais: undefined, NaN e Infinity não fazem parte do JSON.

A linha e a coluna da mensagem de erro indicam onde o parser deu pelo problema. O verdadeiro erro está às vezes um pouco antes dessa posição, por exemplo uma vírgula em falta no fim da linha anterior.

Seguro para dados sensíveis

Toda a formatação, minificação e validação acontece localmente no teu navegador. O teu JSON nunca é enviado para um servidor. Isto é importante porque o JSON contém muitas vezes informação sensível: respostas de API com dados de clientes, tokens de acesso, ficheiros de configuração internos ou registos. Com esta ferramenta, esses dados ficam na tua máquina.

Perguntas frequentes

O meu JSON é enviado para um servidor?

Não. A ferramenta corre inteiramente no teu navegador, por isso os teus dados nunca saem do teu dispositivo. Podes usá-la com respostas de API, ficheiros de configuração e outros dados confidenciais.

Qual é a diferença entre formatar e minificar?

Formatar acrescenta quebras de linha e indentação para tornar o JSON fácil de ler por pessoas. Minificar retira todos os espaços desnecessários para o tornar o mais compacto possível para as máquinas. Os dois produzem os mesmos dados.

Devo usar 2 espaços, 4 espaços ou tabulações?

É apenas uma questão de estilo, e os dados ficam iguais em qualquer caso. Dois espaços é comum em projetos JavaScript e na documentação de APIs, 4 espaços é comum em projetos Python, e as tabulações deixam cada leitor escolher a largura de apresentação. Escolhe o que corresponder ao teu projeto.

Ordenar as chaves altera os meus dados?

Não. Em JSON, a ordem das chaves num objeto não tem significado, por isso ordená-las não altera os dados. A ordem dos elementos das listas nunca é alterada.

Porque é que o erro aponta para a linha errada?

O parser indica a posição em que percebeu que o JSON era inválido. Se te esqueceste de uma vírgula ou de umas aspas de fecho, isso acontece muitas vezes no início da linha ou do valor seguinte. Olha também para o que está logo antes da posição indicada.

A ferramenta corrige JSON inválido automaticamente?

Não. A ferramenta valida o teu JSON e diz-te exatamente onde está o erro de sintaxe, mas não tenta adivinhar correções. Corrige o erro indicado e formata de novo.

Ferramentas relacionadas