Formations — 1 037 leçons en français

Accueil › TypeScript › Les conventions qui tiennent

Les conventions qui tiennent

Migrer et tenir la compilationavance

Une convention tient si un outil la vérifie. Les autres se perdent en trois mois — le temps qu'un développeur arrive, écrive autrement, et que personne ne le reprenne en revue.

Les trois niveaux, par solidité décroissante

Niveau Exemple Tient ?
Le compilateur strict: true, noUncheckedIndexedAccess toujours
Un linter bloquant no-explicit-any, ban-ts-comment oui
Un document « on préfère les types aux interfaces » non

La configuration qui porte les conventions de ce chapitre

{
  "rules": {
    "@typescript-eslint/no-explicit-any": "error",
    "@typescript-eslint/ban-ts-comment": ["error", {
      "ts-ignore": true,
      "ts-expect-error": "allow-with-description"
    }]
  }
}

La première ligne rend l'any explicite impossible à ajouter sans une dérogation visible. La seconde interdit @ts-ignore et exige une description sur @ts-expect-error — la dette doit dire pourquoi elle existe.

Le minimum en intégration continue

- run: npx tsc --noEmit         # bloquant
- run: npx eslint .             # bloquant
- run: node outils/plancher.mjs # bloquant

Les trois doivent faire échouer la construction. Une vérification non bloquante produit un rapport que personne ne lit.

Une règle sans échec n'est pas une règle, c'est un avis.

Les termes à connaître

Convention vérifiée

Une règle qu'un outil fait échouer. C'est la seule catégorie qui survit à l'arrivée de nouveaux développeurs.

Convention écrite

Une règle dans un document. Elle tient le temps que les auteurs restent, puis se perd silencieusement.

Barrière de type

Le point unique où une donnée externe est validée. En amont, unknown ; en aval, un type garanti.

tsc --noEmit bloquant

La vérification en intégration continue, avec échec de la construction. Sans échec, l'information est ignorée.

Garde-fou automatisé

Règle de linter, crochet de pré-commit, plancher d'erreurs : les trois formes qu'une convention peut prendre pour être tenue.

Dette datée

Une suppression d'erreur accompagnée d'un numéro de ticket. Sans référence, elle devient indéboulonnable.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.