Capítulo 422 de 456

typescript (next.config.js option)

Core Idea

Configures how Next.js handles TypeScript errors and which tsconfig file to use during production builds.

Key Concepts

  • ignoreBuildErrors (default false): lets next build succeed even with TypeScript errors present; completely skips the type-checking step (does not just suppress output).
  • tsconfigPath (default 'tsconfig.json'): points to a custom TS config file for builds/tooling.

Code Examples

module.exports = {
  typescript: {
    ignoreBuildErrors: false,
    tsconfigPath: 'tsconfig.json',
  },
}
  • O que demonstra: as duas opções e seus defaults.

Reference Tables

OptionTypeDefaultDescription
ignoreBuildErrorsbooleanfalseAllow production builds to complete even with TypeScript errors.
tsconfigPathstring'tsconfig.json'Path to a custom tsconfig.json file.

Anti-patterns

  • Ativar ignoreBuildErrors: true sem checar tipos em outro lugar do pipeline: build passa "perigosamente" mesmo com erros reais de tipo; é preciso rodar tsc --noEmit (ou equivalente) no CI/deploy.

Key Takeaways

  1. ignoreBuildErrors bypassa o type-check inteiro, não apenas os erros mostrados.
  2. Use tsconfigPath pra apontar builds/tooling a um tsconfig diferente do usado pelo editor.
  3. Ver a página TypeScript completa (ch428) pra detalhes de "custom tsconfig path".

Connects To

  • TypeScript (ch428): página de guia completo que referencia esta config em detalhe (custom tsconfig, disabling errors).
AnteriorturbopackChunkingPróximourlImports