Como minificar um documento JSON

Para que serve a minificação de JSON

Esta ferramenta transforma texto JSON válido numa versão compacta, sem espaços acrescentados depois de vírgulas ou dois-pontos. É útil quando precisa de preparar um JSON para transmissão, comparação ou utilização num contexto em que uma representação mais curta seja conveniente. A operação interpreta primeiro o JSON e só depois serializa os dados, pelo que não se limita a apagar espaços literalmente.

Instruções passo a passo

1. Prepare o conteúdo em formato JSON e confirme que o texto não contém erros de sintaxe. Pode incluir objetos, listas, números, texto, valores booleanos e null, desde que a estrutura seja JSON válido.

2. Introduza o texto no campo de entrada disponível e execute a ferramenta. A entrada é opcional; se não fornecer conteúdo, a ferramenta trata o texto vazio ou composto apenas por espaços como um caso válido especial.

3. Para uma entrada não vazia, verifique se a codificação UTF-8 não ultrapassa 1 000 000 bytes. Este limite é medido em bytes, por isso não corresponde necessariamente ao número de caracteres quando existem caracteres fora de ASCII.

4. Leia o resultado devolvido. Se o JSON for válido e estiver dentro do limite, encontrará texto JSON compactado. Se houver um erro de sintaxe, reveja a linha e a coluna indicadas no resultado e corrija o conteúdo antes de tentar novamente.

Como interpretar o resultado

Num resultado bem-sucedido e não vazio, os tamanhos de entrada e saída são apresentados como contagens de caracteres. A poupança indicada não assume valores negativos e a percentagem de poupança é arredondada a uma casa decimal. Assim, um JSON pode ficar com o mesmo tamanho comunicado quando a serialização compacta não reduz a contagem; não deve presumir uma redução em todos os casos.

A compactação remove a formatação dispensável da representação JSON, mas mantém os dados interpretados. Os caracteres não ASCII não são obrigatoriamente convertidos em sequências de escape ASCII. Se a entrada for vazia ou contiver apenas espaços, o resultado é vazio e as medições de tamanho e poupança são zero.

Uma entrada não textual é rejeitada. JSON não vazio com sintaxe inválida gera um resultado malsucedido com a localização detetada, enquanto uma entrada acima do limite de 1 000 000 bytes é rejeitada antes da análise. Estes casos não devem ser tratados como resultados compactados.

Exemplo prático

Uma pessoa recebe um objeto JSON formatado com espaços e pretende obter uma representação compacta para o transportar noutro sistema.

Cole o texto { "nome": "Ana", "ativo": true } no campo de entrada e execute a ferramenta. Depois, consulte o texto JSON devolvido e as medições apresentadas.

O resultado bem-sucedido contém texto JSON compacto e medições de entrada, saída e poupança; os valores dependem do conteúdo processado.

Limitações

• A entrada não vazia cuja codificação UTF-8 exceda 1 000 000 bytes é rejeitada antes da análise.
• Entradas que não sejam texto são rejeitadas e as medições de tamanho referem-se a contagens de caracteres, não a bytes.

Erros comuns

• Um erro frequente é colar JSON com uma vírgula a mais, aspas em falta ou chavetas desequilibradas. Corrija a sintaxe indicada pela linha e coluna do resultado e volte a executar a ferramenta.

Perguntas frequentes

Posso executar a ferramenta sem introduzir JSON?

Sim, quando a entrada estiver vazia ou contiver apenas espaços: esse caso é tratado como válido e devolve um resultado vazio, com medições a zero.

O JSON fica sempre mais pequeno?

Não necessariamente: a poupança não pode ser negativa e a percentagem é arredondada a uma casa decimal, pelo que a representação pode não apresentar redução de tamanho.

Os caracteres não ASCII são convertidos em escapes?

Sim. A serialização compacta não força os caracteres não ASCII a serem convertidos em sequências de escape ASCII.