Capítulo 128 de 456

dynamicParams

Core Idea

Controla o que acontece quando um dynamic segment é acessado sem ter sido gerado por generateStaticParams: gerar sob demanda ou retornar 404.

Key Concepts

  • dynamicParams: export booleano (true padrão / false) em layout, page ou route.
  • true (default): segmentos dinâmicos não incluídos em generateStaticParams são gerados em request time.
  • false: segmentos não incluídos retornam 404.

Code Examples

export const dynamicParams = true // true | false
  • O que demonstra: sintaxe mínima da config.

Anti-patterns

  • Usar dynamicParams com Cache Components habilitado: a opção não está disponível quando cacheComponents está ligado.

Key Takeaways

  1. Substitui o antigo fallback: true | false | blocking de getStaticPaths do Pages Router.
  2. false é útil para forçar 404 em params não pré-gerados (ex.: catálogo fechado de produtos).
  3. Não combine com Cache Components — a opção é ignorada/nem disponível nesse modo.

Connects To

  • generateStaticParams: define quais params são pré-gerados; dynamicParams decide o comportamento para o resto.
  • route-segment-config: dynamicParams é uma das opções desse conjunto.