turbopack.ignoreIssue

Core Idea

Filtra erros e warnings específicos do Turbopack para que não apareçam no output do CLI nem no error overlay, útil para suprimir avisos conhecidos e inofensivos (ex. dependências opcionais não resolvidas intencionalmente). Só funciona com next dev --turbopack.

Key Concepts

• turbopack.ignoreIssue: array de regras; cada regra é um objeto com path (obrigatório), title e description (opcionais).
• Match: uma issue é suprimida quando casa com path e todos os outros campos especificados na regra; se só path for dado, qualquer issue daquele arquivo é suprimida.
• path: glob pattern (string) ou RegExp que casa com o caminho do arquivo onde a issue se originou.
• title: match exato de string, ou RegExp, contra o título da issue.
• description: match exato de string, ou RegExp, contra a descrição da issue.

Code Examples

const nextConfig: NextConfig = {
  turbopack: {
    ignoreIssue: [
      {
        path: '**/lib/optional-feature/**',
        title: 'Module not found',
      },
    ],
  },
}

• O que demonstra: suprimir warnings de "Module not found" vindos de um diretório específico onde há require() opcional dentro de try/catch.

module.exports = {
  turbopack: {
    ignoreIssue: [
      { path: '**/vendor/**' },
      { path: '**/legacy/**', title: 'Module not found' },
      { path: /generated\//, description: /expected identifier/ },
    ],
  },
}

• O que demonstra: combinar múltiplas regras, cada uma com granularidade diferente (só path, path+title, path+description via regex).

Reference Tables

Field	Type	Required	Description
path	string | RegExp	Yes	Casa com o file path da issue.
title	string | RegExp	No	Casa com o título da issue.
description	string | RegExp	No	Casa com a descrição da issue.

Version	Changes
v16.2.0	turbopack.ignoreIssue introduced.

Anti-patterns

• Depender de title/description como filtro primário: podem mudar entre versões do Turbopack; a doc recomenda preferir path patterns mais específicos por serem mais estáveis.

Key Takeaways

1. Só tem efeito com next dev --turbopack, não se aplica a build/webpack.
2. Regra sem title/description suprime toda issue do path casado, use com cuidado para não esconder erros reais.
3. Boa prática: usar patterns de path bem específicos em vez de matches amplos de title/description.

Connects To

• turbopack: opção-pai que agrupa ignoreIssue junto com rules, resolveAlias, etc.