JSON legível ou compacto, qual escolher
Publicado em · Atualizado em 3 min de leitura
Um arquivo JSON é uma maneira de escrever dados em forma de texto: uma lista de lotes, as configurações de um aplicativo, a resposta de um site a outro. O mesmo conteúdo pode ser escrito de duas maneiras, legível ou compacta, e a escolha depende do que você quer fazer com ele.
A forma legível
Na forma legível, cada informação fica em sua própria linha e é deslocada alguns espaços conforme o seu lugar, o que se chama indentação. Vê-se de relance o que está dentro de quê. É a forma indicada quando você relê um arquivo, o compara com outra versão ou procura um erro. Dois ou quatro espaços de deslocamento parecem iguais ao olho. Quatro espaços deixam o arquivo um pouco mais arejado, mas também mais pesado, porque cada espaço conta.
A forma compacta
Na forma compacta, chamada minificada, tudo é escrito em sequência, sem quebras de linha nem espaços desnecessários. O conteúdo é exatamente o mesmo, mas fica difícil de ler para uma pessoa. Essa forma serve quando o arquivo circula: enviado a um site, guardado em grande quantidade ou carregado por uma página web que precisa aparecer rápido. Em uma lista de cerca de quarenta itens, passar de quatro para dois espaços tira cerca de um quinto do peso, e minificar tira quase dois quintos em relação à versão com dois espaços. O que desaparece são apenas espaços e quebras de linha.
Como escolher
Mantenha a forma legível para tudo o que você edita à mão ou compartilha com alguém que precisa entender. Passe para a forma compacta no último momento, logo antes do envio ou da publicação. Guarde sempre a versão legível: dá para voltar da forma compacta para a legível a qualquer momento, mas só se você guardou o arquivo.
Quando usar cada forma
Quem relê a resposta de um servidor, quem confere um arquivo de configurações em um site ou quem prepara dados para uma planilha se dá melhor com a forma legível. Um site que envia seus dados aos visitantes, ou um aplicativo que guarda milhares de registros, ganha velocidade com a forma compacta.
Conferir o resultado
Um JSON minificado deve ser relido exatamente como o original. Abra-o com o formatador: se o arquivo aparece corretamente, nenhum dado foi perdido. Se aparece um erro, o texto de partida não era um JSON válido, e é preciso corrigi-lo antes de continuar.
Para reduzir o peso de um arquivo, veja Minificar JSON.
Perguntas frequentes
- Minificar um JSON muda os dados?
- Não. Só desaparecem os espaços e as quebras de linha. O conteúdo, a ordem e os valores continuam idênticos.
- Quanto de peso se ganha ao minificar?
- Em uma lista de cerca de quarenta itens, passar de quatro para dois espaços tira cerca de um quinto do peso, e minificar tira quase dois quintos em relação a dois espaços. O ganho depende do número de linhas e da profundidade do arquivo.
- É possível voltar à forma legível depois de minificar?
- Sim, abrindo o arquivo com o formatador. Ele restabelece a indentação, mas não os comentários antigos nem a formatação manual, por isso vale a pena guardar a versão legível.
- O que fazer se o formatador mostrar um erro?
- O texto de partida não é um JSON válido: uma vírgula a mais, uma aspa faltando ou um apóstrofo no lugar de uma aspa são as causas mais frequentes.