Capítulo 131 de 456

preferredRegion (deprecated)

Core Idea

Opção depreciada que especificava a região de deploy preferida para um route segment; deve ser removida dos arquivos de rota.

Key Concepts

  • preferredRegion: export string | string[] (deprecated); valor passado para a plataforma de deploy.
  • Múltiplas regiões: um array significa deploy em todas as regiões listadas, não uma escolhida entre elas.
  • Herança: sem valor especificado, herda da layout pai mais próxima; root layout usa 'auto' por padrão; valores de filho sobrescrevem o pai (não fazem merge).
  • Vercel: antes só funcionava com runtime = 'edge' (também deprecated); aceitava 'auto', 'global', 'home'.

Code Examples

export const preferredRegion = // string || string[]
  • O que demonstra: forma de declaração (hoje deve ser removida).

Anti-patterns

  • Manter preferredRegion em código novo: a opção está deprecated; remova o export conforme a mensagem oficial de depreciação.

Key Takeaways

  1. preferredRegion está obsoleta junto com o Edge Runtime; não use em projetos novos.
  2. Se ainda presente em código legado, revise a mensagem de depreciação oficial antes de remover, pois pode haver impacto de deploy.

Connects To

  • runtime: opção relacionada, também com o Edge Runtime deprecated.