Pular para o conteúdo
🛠️
Whiz Tools

Formatador JSON: Minificar e Embelezar JSON Online Grátis

Formatador JSON gratuito para minificar e embelezar JSON instantaneamente. Compacte JSON, valide a sintaxe e imprima de forma elegante com recuo adequado. Ferramenta rápida e segura baseada no navegador.

Formatador JSON

Calculadora de carregamento...
📚

Documentação

Formatador de JSON: Minificar e embelezar JSON

Um formatador de JSON é uma ferramenta que reescreve o texto JSON em outro layout sem alterar os dados contidos nele. Este formatador de JSON faz duas coisas: minifica o JSON, removendo espaços em branco extras, e embeleza o JSON, adicionando indentação e quebras de linha para que as pessoas possam lê-lo.

O que é JSON?

JSON, abreviação de JavaScript Object Notation, é um formato de texto para armazenar e enviar dados. Servidores web o utilizam para enviar informações a aplicativos e navegadores. Programas o utilizam em arquivos de configurações. Ele armazena dados como objetos, escritos com chaves {}, e arrays, escritos com colchetes []. Dentro de um objeto, cada dado tem um nome, chamado chave, e um valor. Um valor pode ser uma string, um número, true, false, null ou outro objeto ou array.

Um pequeno objeto JSON se parece com isto:

1{
2  "name": "John Doe",
3  "age": 30,
4  "isEmployee": true
5}
6

Como este formatador JSON funciona

Algumas ferramentas de JSON leem o texto em uma estrutura de dados própria de uma linguagem de programação e depois escrevem essa estrutura novamente como texto. Esse percurso de ida e volta pode alterar os dados. Ele pode reescrever números muito grandes, descartar números grandes demais para serem representados e reordenar as chaves de um objeto.

Esta ferramenta evita isso. Ela lê a entrada caractere por caractere e verifica se ela segue a gramática JSON. Ao reescrever a saída, copia cada número e cada string exatamente como foram digitados, na mesma ordem. Minificar ou embelezar um documento nunca altera um número, uma chave, a ordem das chaves nem uma chave duplicada.

Se o texto não for um JSON válido, a ferramenta para e mostra um erro em vez de tentar adivinhar o que se pretendia.

A formatação ocorre no navegador. A ferramenta não envia o texto colado para um servidor. A entrada é adicionada ao endereço web da página como um parâmetro de consulta, para que um documento formatado possa ser compartilhado ou salvo nos favoritos por meio de um link.

Como minificar JSON

  1. Cole o JSON na caixa de entrada.
  2. Clique em "Minificar".
  3. A ferramenta remove espaços, tabulações e quebras de linha entre os tokens e mostra o resultado abaixo.
  4. Clique em "Copiar", acima do resultado, para copiá-lo.

Exemplo prático

Antes:

1{
2  "name": "John Smith",
3  "age": 32,
4  "skills": [
5    "JavaScript",
6    "HTML",
7    "CSS"
8  ]
9}
10

Depois:

1{"name":"John Smith","age":32,"skills":["JavaScript","HTML","CSS"]}
2

Fórmula de minificação de JSON

O espaço economizado pela minificação pode ser escrito como:

Espac¸o economizado=(1−tamanho minificadotamanho original)×100%\text{Espaço economizado} = \left(1 - \frac{\text{tamanho minificado}}{\text{tamanho original}}\right) \times 100\%

No exemplo acima, a versão formatada tem 98 bytes e a versão minificada tem 67 bytes:

(1−6798)×100%≈32%\left(1 - \frac{67}{98}\right) \times 100\% \approx 32\%

A economia exata depende da quantidade de espaços em branco e da indentação que o documento original tinha. Um documento com aninhamento profundo e indentação de 4 espaços diminui mais do que um documento que já era compacto.

Como embelezar JSON

  1. Cole o JSON na caixa de entrada. Ele já pode estar minificado ou formatado de maneira desorganizada.
  2. Clique em "Embelezar".
  3. A ferramenta adiciona indentação de 2 espaços, uma quebra de linha para cada chave ou item de array e um espaço depois de cada dois-pontos.
  4. Clique em "Copiar", acima do resultado, para copiá-lo.

Exemplo prático

Antes:

1{"name":"John Smith","age":32,"skills":["JavaScript","HTML","CSS"]}
2

Depois:

1{
2  "name": "John Smith",
3  "age": 32,
4  "skills": [
5    "JavaScript",
6    "HTML",
7    "CSS"
8  ]
9}
10

Um objeto ou array vazio permanece em uma única linha, como {} ou [], em vez de ser dividido em três linhas.

Erros comuns de JSON detectados por esta ferramenta

JSON tem uma gramática rígida, mais rígida que a de uma linguagem de programação típica. Esta ferramenta rejeita textos que violem qualquer uma destas regras e mostra a mensagem "JSON inválido" em vez de um resultado:

  • Uma vírgula ausente entre dois valores.
  • Uma vírgula após o último item de um objeto ou array (não permitida em JSON, ao contrário do JavaScript).
  • Uma chave que não esteja entre aspas duplas.
  • Aspas simples ao redor de uma string em vez de aspas duplas.
  • Colchetes e chaves incompatíveis ou ausentes.
  • Uma sequência de escape inválida ou incompleta dentro de uma string, como uma barra invertida isolada.
  • Um caractere de controle, como uma quebra de linha ou tabulação real, digitado dentro de uma string em vez de ser escrito como \n ou \t.
  • Um número em uma forma não permitida pelo JSON, como um zero à esquerda (01), um ponto decimal final (1.) ou um sinal de mais à esquerda (+1).

JSON também não tem sintaxe para comentários. O texto que começa com // ou /* não faz parte da gramática JSON, portanto colar JSON que contenha comentários produz um erro de "JSON inválido", em vez de um JSON com os comentários removidos discretamente. Para formatar esse arquivo, remova primeiro os comentários.

Casos de uso de um formatador de JSON

  • Desenvolvimento web: leitura de respostas de APIs durante a depuração e minificação de arquivos de configuração antes da implantação.
  • Desenvolvimento de APIs: verificação de que o corpo de uma solicitação ou resposta é um JSON bem-formado.
  • Análise de dados: conversão de uma exportação JSON compacta em um layout legível para inspeção.
  • Arquivos de configuração: embelezamento de um arquivo de configuração antes de editá-lo manualmente e posterior minificação.

Alternativas

Editores de código, como o Visual Studio Code, podem formatar arquivos JSON sem sair do editor. Ferramentas de linha de comando, como jq, podem formatar e filtrar JSON como parte de um script. As linguagens de programação também incluem bibliotecas JSON, como o módulo json do Python ou o objeto integrado JSON do JavaScript, que a maioria dos programas utiliza para analisar JSON em suas próprias estruturas de dados. Um formatador online como este é útil quando é necessária uma verificação rápida e pontual sem instalar nada.

História do JSON

Douglas Crockford especificou o JSON no início dos 2000, com base na maneira como o JavaScript escreve literais de objetos, mas projetado para ser lido e escrito por qualquer linguagem de programação. O formato foi documentado publicamente pela primeira vez por volta de 2001 e posteriormente padronizado como RFC 4627 em (11.800 cm) 2006, como ECMA-404 em (1.030 cm) 2013 e como RFC 8259 em (21.000 cm) 2017. À medida que as APIs web se expandiram ao longo dos 2000, o JSON substituiu o XML como o formato mais comum para enviar dados entre servidores e navegadores, principalmente porque é mais curto e mapeia diretamente para estruturas de dados já integradas ao JavaScript. Ferramentas de formatação e validação surgiram à medida que os documentos JSON ficaram maiores e mais aninhados.

Dúvidas frequentes

A minificação remove comentários do JSON? Não. JSON não tem sintaxe para comentários, e esta ferramenta não adiciona uma. Se a entrada contiver comentários no estilo // ou /*, a ferramenta informa um erro de "JSON inválido" em vez de formatá-la. Remova os comentários antes de colar o texto.

A formatação altera meus números ou a ordem das minhas chaves? Não. A ferramenta copia cada número e string exatamente como foram escritos e mantém as chaves na ordem original, incluindo chaves duplicadas, se houver.

Que indentação o embelezador usa? Dois espaços por nível de aninhamento, com um espaço depois de cada dois-pontos.

Meus dados JSON são enviados para um servidor? Não. A formatação é executada no navegador. O texto colado é copiado para a URL da página como um parâmetro de consulta json, para que a página possa ser compartilhada ou salva nos favoritos. Nada é enviado.

Há um limite de tamanho? Não há um limite fixo, mas o documento inteiro permanece na memória enquanto é analisado, portanto um arquivo muito grande, com muitos megabytes, pode ser lento em um dispositivo mais antigo.

Um JSON inválido será corrigido apenas parcialmente? Não. Se a entrada violar a gramática JSON em qualquer ponto, a ferramenta mostra um erro em vez de retornar um resultado parcial ou presumido.

Referências

  1. "Introducing JSON." JSON.org, https://www.json.org/json-en.html.
  2. Bray, T., ed. "The JavaScript Object Notation (JSON) Data Interchange Format." RFC 8259, IETF, dezembro de 2017, https://www.rfc-editor.org/rfc/rfc8259.
  3. "ECMA-404: The JSON Data Interchange Syntax." Ecma International, https://www.ecma-international.org/publications-and-standards/standards/ecma-404/.
  4. "JSON." MDN Web Docs, Mozilla, https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON.