Aninhamento Profundo

ID: deep_nesting | Gravidade: Low (default)

Identifica blocos de código (if, for, while, etc.) que estão aninhados muito profundamente.

Por que isso é um smell

Código profundamente aninhado é exponencialmente mais difícil de ler e entender. Muitas vezes é um sinal de que uma função está fazendo demais ou que a lógica pode ser simplificada.

Como corrigir

• Guard Clauses: Retorne antecipadamente para evitar blocos else e reduzir o aninhamento.
• Extract Function: Mova o bloco aninhado interno para uma nova função.
• Flatten Logic: Reavalie a lógica para ver se ela pode ser expressa de forma mais simples.

Configuração

rules:
  deep_nesting:
    severity: low
    max_depth: 4

Regra ESLint

Este detector está disponível como uma regra ESLint para feedback em tempo real no seu editor.

// eslint.config.js
export default [
  {
    rules: {
      '@archlinter/no-deep-nesting': 'warn',
    },
  },
];

Veja Integração ESLint para instruções de configuração.