Clean Code en JavaScript: principios y ejemplos prácticos

Clean Code en JavaScript: principios y ejemplos prácticos

El código limpio (Clean Code) no es solo un término de moda, sino una filosofía de desarrollo que transforma un conjunto caótico de instrucciones en un sistema ordenado, legible y mantenible. En el mundo de JavaScript y Node.js, donde los proyectos crecen y se vuelven complejos rápidamente, la habilidad de escribir código limpio se convierte en una competencia críticamente importante. En este artículo, analizaremos los principios clave de Clean Code con ejemplos concretos utilizando Node.js.

¿Por qué es importante el código limpio para un desarrollador de JavaScript?

JavaScript es un lenguaje de tipado dinámico y alta flexibilidad, lo que es a la vez su fortaleza y una fuente de problemas. Sin seguir las disciplinas del código limpio, un proyecto se convierte rápidamente en un "pantano", donde cualquier cambio puede romper partes inesperadas del sistema. Clean Code ayuda a:

\n
• Reducir la cantidad de errores y el tiempo para encontrarlos.
\n
• Acelerar la incorporación de nuevos desarrolladores al proyecto.
\n
• Facilitar la refactorización y escalabilidad de la base de código.
\n
• Mejorar la calidad de las revisiones de código (code review).
\n

Principio 1: Nombres significativos: la base de la comprensión

El primer y más importante principio de Clean Code es el nombramiento correcto de variables, funciones, clases y archivos. El nombre debe responder a las preguntas "¿qué es esto?" y "¿para qué sirve?". Evite variables de una sola letra (excepto contadores de bucles) y nombres abstractos.

Ejemplo malo (Node.js):

// ¿Qué hace esta función? No está claro.\nfunction d(a, b) {\n  let r = [];\n  for (let i = 0; i < a.length; i++) {\n    if (b.includes(a[i])) {\n      r.push(a[i]);\n    }\n  }\n  return r;\n}\n\n// Uso\nconst arr1 = [1, 2, 3, 4, 5];\nconst arr2 = [3, 4, 5, 6, 7];\nconst result = d(arr1, arr2);\nconsole.log(result); // [3, 4, 5]

Ejemplo bueno (Clean Code):

// El nombre de la función y los parámetros hablan por sí mismos\nfunction findCommonElements(array1, array2) {\n  const commonElements = [];\n  for (const element of array1) {\n    if (array2.includes(element)) {\n      commonElements.push(element);\n    }\n  }\n  return commonElements;\n}\n\n// Uso\nconst firstList = [1, 2, 3, 4, 5];\nconst secondList = [3, 4, 5, 6, 7];\nconst intersection = findCommonElements(firstList, secondList);\nconsole.log(intersection); // [3, 4, 5]

Recomendaciones adicionales para el nombramiento:

\n
• Variables booleanas: use prefijos is, has, can (por ejemplo, isActive, hasPermission).
\n
• Funciones: use verbos (getUserData, validateEmail, sendNotification).
\n
• Constantes: escríbalas en UPPER_SNAKE_CASE (MAX_RETRY_COUNT, DEFAULT_TIMEOUT_MS).
\n

Principio 2: Funciones pequeñas con una sola responsabilidad

Cada función debe hacer solo una cosa y hacerla bien. Si una función realiza varias acciones (por ejemplo, validar datos, hacer una consulta a la base de datos y enviar un correo electrónico), debe dividirse en varias funciones pequeñas. Esto mejora la capacidad de prueba y la reutilización del código.

Ejemplo malo (Node.js Express):

app.post('/api/users', async (req, res) => {\n  const { name, email, password } = req.body;\n\n  // Validación\n  if (!name || !email || !password) {\n    return res.status(400).json({ error: 'Campos faltantes' });\n  }\n  if (password.length < 8) {\n    return res.status(400).json({ error: 'Contraseña demasiado corta' });\n  }\n\n  // Trabajo con la base de datos\n  const existingUser = await db.findUserByEmail(email);\n  if (existingUser) {\n    return res.status(409).json({ error: 'El usuario ya existe' });\n  }\n\n  const hashedPassword = await bcrypt.hash(password, 10);\n  const newUser = await db.createUser({ name, email, password: hashedPassword });\n\n  //