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.
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.