¿Cómo determinas que el código está bien escrito?

El código de calidad es conciso, legible y comprensible para otros desarrolladores. Sigue las convenciones y estándares de codificación aceptados.

Criterios principales de calidad del código:

• Legibilidad y mantenibilidad: Fácil de leer, entender y modificar.
• Rendimiento: Utiliza eficientemente los recursos y se ejecuta rápidamente.
• Testabilidad: Escrito de manera que sea fácil de cubrir con pruebas.
• Fiabilidad: Funciona de manera predecible y no contiene errores críticos.
• Escalabilidad: Fácil de ampliar y mejorar la funcionalidad.

Herramientas y prácticas para garantizar la calidad:

1. Linters y formateadores: eslint, prettier para revisión y formateo automático del código.
2. Escritura de pruebas: Pruebas unitarias, de integración y E2E.
3. Revisión de código: Revisión por colegas para detectar posibles problemas.
4. Seguir patrones de diseño y principios SOLID.
5. Buena documentación: Explicación de partes complejas del código y API.

Ejemplo de código poco legible:

// Código pobre
function procData(d) {
  let res = [];
  for (let i = 0; i < d.length; i++) {
    if (d[i].val > 0) {
      res.push(d[i].val * 2);
    }
  }
  return res;
}

Ejemplo de código de calidad con las mismas funciones:

// Buen código. Uso de nombres comprensibles y métodos de arrays
function processPositiveValuesDoubled(data) {
  return data
    .filter(item => item.value > 0) // Filtra elementos con valor positivo
    .map(item => item.value * 2); // Duplica el valor
}