turbopackMemoryEviction

Core Idea

Controla se e quando o Turbopack libera da memória os dados já persistidos no cache em disco (FileSystem cache), trocando uso de RAM por releitura do disco sob demanda durante next dev.

Key Concepts

• turbopackMemoryEviction: false | 'auto' (default) | 'full'.
• false: nunca faz eviction; dados cacheados ficam em memória durante toda a vida do processo.
• 'auto' (default): faz eviction após um snapshot só quando memória suficiente foi alocada desde a última eviction, usando thresholds e feedback de pressão de memória do sistema operacional.
• 'full': evict de tudo possível da memória a cada vez que salva no disco.

Code Examples

const nextConfig: NextConfig = {
  experimental: {
    turbopackMemoryEviction: 'auto',
  },
}

• O que demonstra: valor default explícito, equilíbrio automático entre memória e disco.

Reference Tables

Version	Changes
v16.3.0	turbopackMemoryEviction released as experimental.

Anti-patterns

• Esperar efeito sem o FileSystem Cache habilitado: só tem efeito em sessões next dev quando o cache persistente (turbopackFileSystemCache) está ativo, já que eviction depende dos dados já estarem salvos em disco.

Key Takeaways

1. Feature experimental e em desenvolvimento ativo, comportamento pode mudar.
2. false maximiza velocidade (tudo em RAM) ao custo de uso de memória; 'full' minimiza uso de RAM ao custo de mais releitura de disco.
3. Só relevante em dev, não afeta next build.

Connects To

• turbopackFileSystemCache: pré-requisito, eviction só age sobre dados já persistidos por esse cache.