compress

Core Idea

Controla a compressão gzip automática que o Next.js aplica ao conteúdo renderizado e arquivos estáticos em next start ou custom server.

Key Concepts

• compress: boolean, default true; usa gzip automaticamente quando não há compressão já configurada no servidor
• Accept-Encoding / Content-Encoding: headers para verificar se e qual compressão está ativa

Code Examples

module.exports = {
  compress: false,
}

• O que demonstra: desativar a compressão automática do Next.js.

Anti-patterns

• Desativar sem ter compressão configurada em outro lugar: reduz bandwidth e performance sem necessidade
• Manter compress: true junto de nginx/outro proxy já comprimindo: Next.js detecta compressão já configurada via custom server e não duplica, mas se o cenário for nginx com brotli, setar compress: false explicitamente para deixar o nginx assumir

Key Takeaways

1. Só desativar se já existe compressão configurada no servidor (ex.: nginx com brotli)
2. A compressão só se aplica a next start/custom server, não a outros modos de deploy que já cuidam disso

Connects To

• next.config.js Options (ch388): opção geral de performance/servidor