Bonnes Pratiques TypeScript pour un Code Propre et Maintenable

TypeScript brille quand il vous aide à modéliser la réalité — pas quand il vous force à vous battre avec les types toute la journée. Quelques réglages par défaut peuvent rendre une codebase plus sérieuse, plus sûre et plus facile à refactoriser.

Règles pratiques

• Activez la strictness et corrigez les arêtes vives tôt.
• Préférez des types lisibles à des types astucieux.
• Utilisez les unions pour « l'un d'entre eux », les interfaces pour « la forme de ça ».
• Évitez any comme raccourci ; ça devient vite de la dette future.

Un pattern à retenir

type Result<T> = { ok: true; value: T } | { ok: false; error: string };

export function parseNumber(input: string): Result<number> {
  const n = Number(input);
  return Number.isFinite(n)
    ? { ok: true, value: n }
    : { ok: false, error: "Not a number" };
}

Conclusion

Le meilleur code TypeScript se lit comme une bonne documentation : noms clairs, formes prévisibles, et erreurs qui pointent vers la correction.