Gardien de la Qualité

function processOrder(order) {
  if (order) {
    if (order.items) {
      if (order.items.length > 0) {
        if (order.customer) {
          if (order.customer.active) {
            // Finally, the actual logic...
            return calculateTotal(order)
          }
        }
      }
    }
  }
  return null
}

5 niveaux d'imbrication — difficile à lire et à maintenir

function processOrder(order) {
  if (!isValidOrder(order)) return null
  return calculateTotal(order)
}

function isValidOrder(order) {
  return order?.items?.length > 0
    && order?.customer?.active
}

Extraction de la clause de garde, aplatissement de la structure

function calculateDiscount(total) {
  if (total > 100) return total * 0.1
  if (total > 50) return total * 0.05
  return 0
}

Nombres magiques : que signifient 100, 50, 0.1 ?

const DISCOUNT_TIERS = {
  PREMIUM: { threshold: 100, rate: 0.10 },
  STANDARD: { threshold: 50, rate: 0.05 },
}

function calculateDiscount(total) {
  const tier = Object.values(DISCOUNT_TIERS)
    .find(t => total > t.threshold)
  return tier ? total * tier.rate : 0
}

Extraction de constantes avec des noms significatifs

function calc(d, t) {
  const r = d / t
  const x = r * 3.6
  return x
}

Noms cryptiques : d, t, r, x ne vous disent rien

const MS_TO_KMH = 3.6

function calculateSpeedKmh(distanceMeters, timeSeconds) {
  const metersPerSecond = distanceMeters / timeSeconds
  return metersPerSecond * MS_TO_KMH
}

Noms descriptifs qui expliquent l'objectif