Regla
Evite profundo anidamiento niveles.
En profundo hace que código difícil de leer y entender.
Idiomas admitidos: 45+

Introducción

El código con cuatro, cinco o seis niveles de anidamiento crea una carga cognitiva que ralentiza el desarrollo. Cada nivel de anidamiento dificulta el seguimiento de las condiciones activas, las rutas de error y la lógica de negocio. Un anidamiento excesivo a menudo indica la falta de abstracciones o de oportunidades para usar retornos anticipados y cláusulas de guarda.

Por qué es importante

Mantenibilidad del código y riesgos de errores: El anidamiento profundo crea un "código flecha" que desplaza la lógica fuera de la pantalla, ralentizando la revisión del código. Los desarrolladores pasan por alto casos límite al modificar código anidado porque no pueden ver todas las condiciones que deben cumplirse. Los cambios que parecen correctos de forma aislada pueden romper suposiciones hechas en niveles superiores.

Complejidad de las pruebas y la depuración: Cada nivel de anidamiento duplica los casos de prueba necesarios para la cobertura, creando una explosión exponencial de rutas. Las trazas de pila de los errores no muestran qué condiciones llevaron a ellos, lo que dificulta la reproducción de los errores.

Ejemplos de código

❌ No conforme:

function processOrder(order) {
    if (order) {
        if (order.items && order.items.length > 0) {
            if (order.customer) {
                if (order.customer.address) {
                    if (order.paymentMethod) {
                        if (validatePayment(order.paymentMethod)) {
                            return submitOrder(order);
                        }
                    }
                }
            }
        }
    }
    return { error: 'Invalid order' };
}

Por qué está mal: Seis niveles de anidamiento dificultan ver la lógica de negocio real (envío de pedidos) enterrada al final. Cada comprobación de condición añade otra capa de indentación, y el manejo de errores no es claro porque no hay indicación de qué validación específica falló.

✅ Conforme:

function processOrder(order) {
    if (!order) {
        return { error: 'Order is required' };
    }

    if (!order.items || order.items.length === 0) {
        return { error: 'Order must contain items' };
    }

    if (!order.customer?.address) {
        return { error: 'Customer address is required' };
    }

    if (!order.paymentMethod || !validatePayment(order.paymentMethod)) {
        return { error: 'Invalid payment method' };
    }

    return submitOrder(order);
}

Por qué esto es importante: Las cláusulas de guarda con retornos anticipados aplanan el anidamiento a un único nivel. Cada validación es explícita y devuelve un mensaje de error específico. La ruta feliz (envío de pedido) es visible al final sin anidamiento. El código se autodocumenta y es fácil de modificar sin romper las condiciones existentes.

Conclusión

Mantén los niveles de anidamiento en tres o menos siempre que sea posible. Utiliza retornos anticipados, cláusulas de guarda y funciones auxiliares para aplanar estructuras profundamente anidadas. Cuando encuentres un anidamiento más allá de tres niveles, es una señal para refactorizar extrayendo métodos, invirtiendo condiciones o replanteando el enfoque. El código plano es más fácil de leer, probar, depurar y mantener que las alternativas profundamente anidadas.