Capítulo 205 de 456

compress

Core Idea

Next.js uses gzip to compress rendered content and static files by default under next start or a custom server; disable it only if compression is already configured elsewhere (e.g. nginx handling brotli).

Key Concepts

  • compress: boolean config, default true; controls built-in gzip compression.
  • Auto-detection: if compression is already configured via a custom server, Next.js does not add its own.
  • Verification: check Accept-Encoding (browser) and Content-Encoding (response) headers to confirm what's active.

Code Examples

module.exports = {
  compress: false,
}
  • O que demonstra: desabilitar a compressão gzip embutida.

Anti-patterns

  • Desabilitar sem ter compressão configurada em outro lugar: perde economia de banda e performance; só desabilite se, por exemplo, nginx for cuidar de brotli.

Key Takeaways

  1. Compressão gzip vem ligada por padrão em next start/custom server.
  2. Desabilite só quando outra camada (nginx, CDN) já comprime, evitando trabalho duplicado.

Connects To

  • headers (next.config.js): outra config de resposta HTTP que pode complementar cache/segurança junto com compressão.