Как определяте, че кодът е написан качествено?

Качественият код е кратък, четим и разбираем за други разработчици. Следва приетите конвенции и стандарти за кодиране.

Основните критерии за качество на кода:

• Четливост и поддържане: Лесен за четене, разбиране и модифициране.
• Производителност: Ефективно използва ресурсите и работи бързо.
• Тестируемост: Написан така, че да бъде лесно покрит с тестове.
• Надеждност: Работи предсказуемо и не съдържа критични грешки.
• Мащабируемост: Лесен за разширяване и подобряване на функционалността.

Инструменти и практики за гарантиране на качеството:

1. Линтери и форматиращи: eslint, prettier за автоматична проверка и форматиране.
2. Писане на тестове: Юнит, интеграционни и E2E тестове.
3. Преглед на кода: Преглед от колеги за откриване на потенциални проблеми.
4. Следване на дизайн патърни и SOLID принципи.
5. Добра документация: Обяснение на сложни части от кода и API.

Пример за лошо четим код:

// Лош код
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;
}

Пример за качествен код със същите функции:

// Добър код. Използване на разбираеми имена и методи на масиви
function processPositiveValuesDoubled(data) {
  return data
    .filter(item => item.value > 0) // Филтриране на положителни стойности
    .map(item => item.value * 2); // Удвояване на стойността
}