Capítulo 389 de 456

adapterPath

Core Idea

Opção de config que aponta para um módulo adapter, permitindo que plataformas de deploy ou build systems se integrem ao processo de build do Next.js.

Key Concepts

  • adapterPath: caminho (via require.resolve) para o módulo do adapter customizado
  • NEXT_ADAPTER_PATH: variável de ambiente alternativa para habilitar uso zero-config em plataformas de deploy
  • nextjs/adapter-vercel: implementação de referência completa de um adapter

Code Examples

/** @type {import('next').NextConfig} */
const nextConfig = {
  adapterPath: require.resolve('./my-adapter.js'),
}

module.exports = nextConfig
  • O que demonstra: registro de um adapter customizado local via require.resolve.

Anti-patterns

  • Ignorar a seção dedicada de Adapters: os detalhes reais de implementação (criar adapter, API reference, testing, routing, PPR, runtime, entrypoints, output types) vivem em páginas próprias sob /docs/app/api-reference/adapters/, esta página é só o ponto de entrada da config

Key Takeaways

  1. adapterPath é o hook de integração entre Next.js e a plataforma de deploy/build
  2. NEXT_ADAPTER_PATH evita precisar editar next.config.js manualmente em plataformas que já sabem configurá-la
  3. Para escrever um adapter próprio, consultar a documentação dedicada de Adapters (Creating an Adapter, API Reference, Testing Adapters, Routing with @next/routing, Runtime Integration, Invoking Entrypoints, Output Types, Routing Information, Use Cases)

Connects To

  • next.config.js Options (ch388): página pai que lista adapterPath entre as opções de config
Anteriornext.config.js OptionsPróximoallowedDevOrigins