IA no seu dispositivo — profissional e privado.

Documentos

Minificador JSON: como minificar JSON online e quanto ele diminui

Minificar JSON online: o que um minificador JSON remove, quanto os arquivos diminuem de verdade antes e depois do gzip, e quando vale comprimir JSON e quando não.

Atualizado em 8 de novembro de 20268 min de leitura

Para minificar JSON, cole o texto ou solte o arquivo no minificador JSON e clique em Minificar. A ferramenta remove os espaços, tabulações e quebras de linha entre os tokens, de modo que o documento inteiro vira uma única linha compacta, e mostra o tamanho antes, o tamanho depois e a porcentagem economizada. Seus dados não mudam: cada string, cada número e cada chave saem exatamente como você escreveu. Quanto o arquivo diminui depende de como ele estava indentado. No nosso teste, um arquivo formatado com 2 espaços perdeu 47 % dos bytes, mas só 3 % quando as duas versões foram comprimidas com gzip. É esse segundo número que importa para a maior parte do tráfego da web, e por isso este guia também explica quando vale a pena minificar e quando não.

O que um minificador JSON remove

O JSON permite exatamente quatro caracteres de espaço em branco entre tokens: espaço, tabulação, retorno de carro e quebra de linha. Um arquivo formatado usa esses caracteres para a indentação, para a quebra de linha depois de cada vírgula e para o espaço depois de cada dois-pontos. Nenhum deles carrega dados, então um minificador pode remover todos, e qualquer programa que leia o arquivo obtém o mesmo resultado.

Parte do arquivoO que o minificador fazPor quê
Indentação e quebras de linhaRemovidasPura formatação
Espaço depois de dois-pontos ou vírgulaRemovidoPura formatação
Espaços dentro de uma string, como "João Silva"Mantidos exatamenteFazem parte do valor
Números como 1.50 ou um ID de 19 dígitosMantidos dígito por dígitoReescrever um número pode arredondá-lo
Ordem das chaves e chaves repetidasFicam como foram escritasNenhum objeto é reconstruído
Comentários e vírgula final (só no modo flexível)RemovidosTransforma JSONC em JSON estrito

As últimas linhas importam mais do que parece. Muitos minificadores leem o seu JSON como valores e imprimem tudo de novo. Isso arredonda qualquer inteiro acima de 9.007.199.254.740.991, transforma 1.50 em 1.5, reduz chaves repetidas à última e joga para a frente as chaves que parecem números. Este minificador copia cada token sem mexer nele, então nada disso acontece. Se a entrada já estava minificada, a saída é idêntica e a ferramenta informa 0 % de economia.

Como minificar JSON online, passo a passo

1

Adicione o JSON

Abra o minificador JSON e cole o texto na caixa, ou solte um arquivo. Ele abre .json, .jsonc, .ndjson, .jsonl, .geojson, .har, .map, .webmanifest e .txt, em UTF-8 ou UTF-16.

2

Escolha o dialeto

JSON estrito é o padrão. Escolha Flexível (JSONC) para arquivos de configuração com comentários // ou /* */ ou com vírgula final; os dois são removidos. Marque JSON Lines para logs ou conjuntos de dados com um documento por linha; cada linha é minificada separadamente e as quebras entre os registros continuam lá.

3

Decida as duas opções

Medir o tamanho com gzip vem ligada e acrescenta uma segunda linha de números. Encurtar sequências \uXXXX vem desligada; ligue só se quiser que os caracteres escapados sejam escritos diretamente (veja abaixo).

4

Clique em Minificar

O arquivo é processado no seu dispositivo, com contagem de progresso e um botão Cancelar que funciona de verdade. Cada cartão de arquivo mostra o tamanho bruto antes e depois com a porcentagem economizada e, abaixo, os tamanhos com gzip.

5

Baixe ou copie

Baixar salva o resultado como seuarquivo.min.json (ou .min.ndjson com JSON Lines). Copiar resultado coloca o texto na área de transferência.

Minificação sem perdas com a economia bruta e com gzip, e os modos Estrito, Flexível e JSON Lines. Grátis: um arquivo por vez de até 25 MB, com todos os modos e opções. Pro: até 20 arquivos de uma vez em um único ZIP. Tudo roda no seu dispositivo, não nos nossos servidores.

Minificar JSON

Quanto um JSON minificado diminui?

Pegamos um documento de teste, uma lista no estilo de API com 500 registros de clientes, com endereços e pedidos aninhados, e salvamos de quatro jeitos. Os dados são idênticos em todas as linhas; só muda o espaço em branco.

Salvo comTamanho brutoMinificadoEconomia brutaCom gzip antes → depoisEconomia com gzip
Indentação com tabulação153,7 KB100,7 KB34 %11,2 KB → 10,4 KB7 %
Indentação de 2 espaços190,2 KB100,7 KB47 %10,7 KB → 10,4 KB3 %
Indentação de 4 espaços263,2 KB100,7 KB62 %12,6 KB → 10,4 KB17 %
Já minificado100,7 KB100,7 KB0 %10,4 KB → 10,4 KB0 %

Duas coisas chamam a atenção. Primeiro, a economia bruta depende totalmente da indentação: mais aninhamento e recuos mais largos significam mais espaços para remover, e é por isso que os arquivos com 4 espaços são os que mais diminuem. Segundo, o gzip já tinha eliminado quase todo esse espaço em branco, porque longas sequências de espaços iguais são a coisa mais fácil de comprimir que existe. Com brotli, que muitos servidores usam, a versão minificada e a de 2 espaços ficaram a uns 50 bytes uma da outra no nosso teste. Os seus números vão ser diferentes, então leia as duas linhas que a ferramenta mostra para o seu arquivo em vez de confiar numa porcentagem genérica.

Se você precisa de um arquivo bem menor do que a minificação consegue deixar, remova o que não usa. Tirar os campos desnecessários com Remover chaves JSON costuma economizar mais do que o espaço em branco jamais economizaria, porque remove dados e não só formatação.

Quando minificar JSON

SituaçãoMinificar?Motivo
Resposta de API enviada com gzip ou brotliOpcionalCostuma render poucos por cento depois da compressão, mas há menos texto para o parser ler
Corpo de requisição enviado por um dispositivo que não comprimeSimA economia bruta é a economia real
JSON embutido numa página web, num script ou no bundle de um appSimMuitas vezes é guardado e entregue sem compressão
JSON guardado numa coluna de banco de dados ou num cacheSimO armazenamento conta bytes brutos
Arquivo de configuração lido do disco (manifesto, ajustes)GeralmenteArquivo menor sem perder nada, mas veja abaixo
Log ou conjunto de dados grande em JSON LinesSim, com JSON Lines ligadoMantém um registro por linha para outras ferramentas

O ponto em comum: minifique quando os bytes trafegam ou ficam guardados sem compressão, ou quando um programa lê o arquivo muitas vezes. Um texto menor também dá menos trabalho para cada parser que o percorre, em cada requisição, e esse custo nenhuma compressão elimina.

Quando não minificar

  • Arquivos que as pessoas editam à mão. Um tsconfig.json ou um arquivo de ajustes minificado é uma única linha comprida que ninguém consegue revisar. Mantenha o original legível e minifique uma cópia para publicar.
  • Arquivos sob controle de versão. Num arquivo de uma linha só, cada alteração vira um diff do documento inteiro. Faça commit da versão formatada e minifique na hora do build ou da exportação.
  • Configuração com comentários de que você precisa. O modo flexível remove os comentários ao minificar, então as notas que explicam um ajuste somem da saída. Guarde o original.
  • Depuração de uma API. Leia a resposta formatada. Se você só tem uma versão minificada, cole no formatador JSON para recuperar a estrutura.
  • Quando o gzip já fez o trabalho. Se a linha do gzip quase não se mexe para o seu arquivo, minificar não é a mudança que vai deixar a página mais rápida.

Encurtar sequências \u e outras opções

Alguns programas que geram JSON escapam todos os caracteres que não são ASCII, e a palavra chinesa 你好 fica guardada como \u4f60\u597d: doze bytes onde seis bastariam em UTF-8. Encurtar sequências \uXXXX escreve esses caracteres diretamente. Qualquer parser lê as duas formas como a mesma string, então o significado não muda, mas os bytes mudam, e é por isso que a opção vem desligada. O ganho é maior em arquivos cheios de texto CJK ou emojis. Ela nunca converte aspas escapadas, uma barra invertida ou um caractere de controle, porque escrever esses caracteres diretamente quebraria o arquivo.

Desligar Medir o tamanho com gzip pula duas passagens de compressão, o que só ajuda em arquivos muito grandes. A saída não muda.

Arquivos grandes e vários arquivos de uma vez

A versão grátis processa um arquivo por vez de até 25 MB, com todos os modos e opções. A página continua respondendo enquanto o arquivo é lido, e você pode cancelar. O Pro acrescenta lotes de até 20 arquivos, cada um com seus próprios números de antes e depois, reunidos em um único ZIP, e aumenta o tamanho por arquivo para o que o seu dispositivo aguentar. Para conferir se um payload é válido antes de publicar, passe pelo validador JSON; para colocar JSON minificado dentro de uma string no código ou em outro documento JSON, use Escapar JSON.

Perguntas frequentes

Como minificar JSON online?

Cole o JSON ou solte o arquivo no minificador, mantenha JSON estrito ou escolha Flexível para arquivos com comentários, clique em Minificar e baixe ou copie o resultado. A versão grátis cobre um arquivo de até 25 MB.

Minificar JSON altera os dados?

Não. Só o espaço em branco entre os tokens é removido. Strings, números, ordem das chaves e chaves repetidas saem exatamente como foram escritos, então IDs longos e valores como 1.50 não são arredondados. Um programa que lê o arquivo minificado recebe os mesmos dados.

Quanto a minificação comprime um JSON?

Depende da indentação. No nosso teste, os mesmos dados diminuíram 34 % a partir de um arquivo com tabulação, 47 % com 2 espaços e 62 % com 4 espaços. Depois do gzip, a economia ficou entre 3 % e 17 %, porque o gzip já comprime muito bem o espaço em branco.

Minificar JSON é o mesmo que comprimir com gzip?

Não. Minificar remove caracteres, e o resultado continua sendo JSON comum que qualquer programa lê. O gzip codifica os bytes, que precisam ser descomprimidos antes da leitura. Os dois se completam: os servidores costumam comprimir com gzip o arquivo já minificado.

Dá para minificar JSON com comentários, como o tsconfig.json?

Dá. Escolha Flexível (JSONC). Esse modo aceita comentários // e /* */ e uma vírgula final, e remove tudo isso, então a saída é JSON estrito. Guarde o original se precisar dos comentários.

Por que o meu JSON diminuiu 0 %?

Ele já estava minificado: não sobrou espaço em branco entre os tokens para remover. A saída é idêntica à entrada. Para diminuir o arquivo, remova os campos de que você não precisa.

Continue lendo

Mais sobre Documentos →