Capítulo 144 de 456

Route Segment Config

Core Idea

Página-índice das opções de configuração de route segment: variáveis exportadas diretamente de page, layout ou route para controlar comportamento (runtime, região, duração, dynamic params).

Key Concepts

  • Route Segment Config: conjunto de exports (dynamicParams, runtime, preferredRegion, maxDuration, e mais especificamente instant/prefetch sob Cache Components) aplicáveis a Page, Layout ou Route Handler.
  • Sob Cache Components (v16), dynamic, dynamicParams, revalidate e fetchCache são removidos do modelo antigo; o novo modelo usa instant/prefetch/use cache em vez disso.

Reference Tables

OptionTypeDefault
dynamicParamsbooleantrue
runtime'nodejs' | 'edge' (deprecated)'nodejs'
preferredRegion'auto' | 'global' | 'home' | string | string[] (deprecated)'auto'
maxDurationnumberDefinido pela plataforma de deploy

Anti-patterns

  • Usar export const experimental_ppr = true: removido na v16.0.0; existe codemod para migração.
  • Usar runtime = 'experimental-edge': deprecated desde v15.0.0-RC; existe codemod para converter para 'edge'.

Key Takeaways

  1. Esta é a página de sumário; cada opção tem sua própria referência detalhada (dynamicParams, instant, maxDuration, preferredRegion, prefetch, runtime).
  2. Com Cache Components habilitado, o conjunto de opções relevante muda drasticamente (menos config legada, mais instant/prefetch/use cache).
  3. Sempre rode os codemods oficiais ao migrar configs deprecated em vez de editar manualmente.

Connects To

  • dynamicParams, instant, maxDuration, preferredRegion (deprecated), prefetch, runtime: páginas de referência individuais desta config.
  • cacheComponents: flag que altera fundamentalmente quais opções de segmento estão disponíveis.