Como formatar e minificar JavaScript

Para que serve o formatador de JavaScript

Esta ferramenta transforma texto JavaScript numa versão formatada para leitura ou numa versão minificada, de acordo com o modo escolhido. É útil quando precisa de reorganizar um excerto de código antes de o rever ou reduzir espaços e comentários fora de textos entre aspas. A formatação altera a apresentação do código; não valida, compila nem executa JavaScript.

Como formatar ou minificar JavaScript

1. Introduza texto JavaScript no campo de entrada. Para obter um resultado, use texto; uma entrada vazia ou composta apenas por espaços também é aceite, mas gera texto formatado vazio.
2. Escolha o modo de saída. Um modo em falta conduz à formatação legível. Para minificar, selecione o modo de minificação; outros modos de texto conduzem à formatação legível.
3. Defina a indentação, se necessário. Para texto não vazio, o valor é convertido num número inteiro. Valores inválidos ou fora do intervalo de 0 a 8 são substituídos por dois espaços, que também são o valor predefinido.
4. Execute a transformação e leia o texto devolvido. Na formatação legível, as quebras de linha existentes são preservadas até ao limite de duas quebras consecutivas, não é acrescentada uma quebra de linha final e não são inseridos espaços dentro de parênteses.
5. Se tiver escolhido a minificação, confirme o resultado no contexto do seu projeto. Esta opção remove comentários de linha e de bloco que estejam fora de textos entre aspas, junta determinados espaços, conserva o conteúdo desses textos, reduz linhas vazias repetidas e remove espaços exteriores.

Como interpretar o resultado

Um resultado com várias linhas indica que o texto foi passado pela formatação legível; o tamanho da indentação ajuda a reconhecer a organização aplicada. Um resultado minificado tende a ocupar menos espaço, mas a remoção de comentários e espaços não significa que o código tenha sido executado ou que mantenha o mesmo comportamento em todos os casos. Reveja literais, comentários e construções JavaScript menos habituais antes de usar o resultado.

Se a ferramenta recusar o conteúdo, verifique primeiro se a entrada é texto, se não ultrapassa 1 000 000 de bytes UTF-8 e se a dependência necessária para a formatação está disponível. Uma entrada não vazia que exceda esse limite falha em vez de ser formatada.

Exemplo prático

Ao preparar uma função curta para revisão, uma pessoa quer substituir a apresentação compacta por texto JavaScript com linhas separadas e indentação legível.

Introduza function soma(a,b){return a+b;}, escolha a formatação legível e defina dois espaços de indentação. Depois, observe a estrutura devolvida e confirme que contém uma quebra de linha.

A saída deve ser texto formatado com pelo menos uma quebra de linha; não é indicado aqui um conteúdo completo de saída.

Limitações

• Texto não vazio com mais de 1 000 000 de bytes UTF-8 falha. A minificação tem regras específicas para comentários, espaços e textos entre aspas, e a transformação também pode falhar se a dependência necessária não estiver disponível.

Erros comuns

• Colar um valor que não seja texto pode fazer a transformação falhar. Introduza o JavaScript como texto e evite enviar valores não textuais; uma entrada vazia pode ser aceite, mas produz uma saída vazia.

Perguntas frequentes

Posso deixar a entrada vazia?

Sim, desde que a entrada seja vazia ou contenha texto JavaScript. Uma entrada vazia ou só com espaços é aceite e devolve texto formatado vazio; uma entrada não textual normalmente falha.

O que acontece no modo de minificação?

Selecione a minificação para remover comentários fora de textos entre aspas, condensar determinados espaços e retirar espaços exteriores. O conteúdo dos textos entre aspas, incluindo caracteres escapados, é preservado.

Que valor de indentação devo escolher?

Para texto não vazio, use um valor inteiro entre 0 e 8. Se o valor for inválido ou ficar fora desse intervalo, são usados dois espaços; esse é também o valor predefinido.