Como validar, formatar e minificar JSON

Reconheça erros de sintaxe e entenda o que o analisador JSON do navegador preserva.

Guia práticoAtualizado Tempo estimado de leitura: 3 min
Nesta página

JSON requer sintaxe precisa

Nomes de propriedade e strings precisam de citações duplas. Comentários, vírgulas, strings indefinidas e com citações simples não são permitidas.

Um exemplo válido é "nome":"Kitavio","local":true. A formatação adiciona indentação e quebras de linha; a minificação remove a formatação sem remover espaços dentro de uma string.

Ler um erro de validação

Quando falhar, inspecione a posição, linha ou coluna relatadas quando disponível. Uma vírgula desaparecida pode causar um erro no seguinte elemento.

A formatação não corrige automaticamente um documento inválido. Corrija a entrada e valide novamente.

  1. Cole JSON sem embalagens Markdown.
  2. Escolha 2 ou 4 espaços para formatação.
  3. Validar e inspecionar a estrutura de saída.
  4. Minifique só depois de confirmar que os dados estão corretos.

Precisão e chaves duplicadas

O navegador JSON.parse e JSON.stringify são usados. Integers além da precisão JavaScript podem mudar, e a última chave duplicada é mantida.

Para preservar números muito grandes, armazená-los como strings ou usar um fluxo de trabalho especializado. A ferramenta é local; formatação não criptografa ou anonimiza dados.

Critérios para revisar e entregar o resultado

Prepare uma amostra refletindo a estrutura do aplicativo: um objeto com campos, um array e vários tipos de valor. Revise a sintaxe antes de alterar o conteúdo para resolver um erro. Comentários, citações simples e vírgulas podem pertencer a outra representação, mas não ao padrão aceito aqui. Se a validação for bem-sucedida enquanto uma API rejeita a amostra, compare campos e tipos com o contrato de recebimento. A análise e a aceitação da aplicação são verificações separadas.

Formatação e minimização da análise de uso e serialização, então não espere que todos os bytes de entrada sobrevivam. Chaves e inteiros repetidos além da precisão numérica comum precisam de atenção especial. Mantenha a fonte para assinaturas, grandes exemplos de identificadores ou representações exatas. Compare a contagem de elementos, strings com espaços e valores importantes antes e depois do processamento. Inspeção de ajudas de saída legível; saída compacta se adapta a alguns campos técnicos. Nenhum dos dois certifica a correção dos negócios. Substitua credenciais e dados reais por valores fictícios antes de usar exemplos na documentação pública. Um pequeno teste representativo é útil para confirmar a estrutura pretendida, preservando o conjunto de dados original para resolver discrepâncias que uma visualização formatada sozinha não pode explicar.

EXPERIMENTE

Revise uma resposta antes de compartilhá-la

Cole "ok":true,"n":2" e use recuo de dois espaços. Em seguida, abra contacts.json em um editor de texto e cole seu conteúdo para tentar uma lista de vários objetos.

O objeto é validado e exibido com uma propriedade por linha. Os valores não são traduzidos ou convertidos para o idioma da interface.

Uma vírgula ou chave não citada produz um erro. A formatação não determina se um campo é válido para uma API de destino: isso depende de seu esquema.