Come si determina che il codice è scritto di qualità?

Un codice di qualità è conciso, leggibile e comprensibile per altri sviluppatori. Segue le convenzioni e gli standard di codifica accettati.

I criteri principali di qualità del codice:

• Leggibilità e manutenibilità: Facile da leggere, comprendere e modificare.
• Prestazioni: Utilizza le risorse in modo efficiente e si esegue rapidamente.
• Testabilità: Scrittura tale da essere facilmente coperto dai test.
• Affidabilità: Funziona in modo prevedibile e non contiene errori critici.
• Scalabilità: Facile da espandere e migliorare le funzionalità.

Strumenti e pratiche per garantire la qualità:

1. Linter e formatter: eslint, prettier per controllo automatico e formattazione del codice.
2. Scrittura di test: Test unitari, di integrazione e E2E.
3. Revisione del codice: Revisione da parte di colleghi per individuare potenziali problemi.
4. Seguire pattern di progettazione e principi SOLID.
5. Buona documentazione: Spiegazione di parti complesse del codice e API.

Esempio di codice poco leggibile:

// Codice cattivo
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;
}

Esempio di codice di qualità con le stesse funzioni:

// Buon codice. Uso di nomi comprensibili e metodi di array
function processPositiveValuesDoubled(data) {
  return data
    .filter(item => item.value > 0) // Filtra elementi con valore positivo
    .map(item => item.value * 2); // Doppia il valore
}