Accueil › TypeScript › Éliminer les any
Éliminer les any
Migrer et tenir la compilationavance
Un any ne reste pas à sa place. Il se propage à tout ce qu'il touche, sans un
seul message, et l'annotation qui le reçoit ne vérifie rien.
const donnees: any = JSON.parse(corps);
const total: number = donnees.montant; // ✅ accepté — aucun contrôle
total.toFixed(2); // 💥 à l'exécution si c'est "12"
unknown, le remplaçant honnête
const donnees: unknown = JSON.parse(corps);
const total: number = donnees.montant;
// ^^^^^^^ ❌ TS18046 : 'donnees' is of type 'unknown'.
unknown accepte tout en entrée et n'autorise rien en sortie sans affinage.
L'erreur apparaît là où l'hypothèse est faite — c'est le seul endroit utile.
Deux familles de any, deux traitements
L'any explicite est écrit à la main : on peut le compter avec grep, le
localiser, le réduire. L'any implicite est invisible : un paramètre non
annoté, un module sans déclarations. Seul noImplicitAny le révèle.
Le plancher d'erreurs
Zéro erreur prend des mois. Pendant ce temps, rien n'empêche le code neuf d'empirer. Le plancher répond à cela : on relève le nombre d'erreurs par fichier, on le versionne, et la construction échoue dès qu'un fichier en gagne une.
src/panier.ts 12 ← référence
src/panier.ts 13 ← ❌ régression : échec
src/panier.ts 9 ← ✅ plancher à abaisser dans le relevé
Un plancher ne fait que descendre. C'est la seule règle, et elle suffit.
Un plancher global est insuffisant : il laisse un fichier gagner trois erreurs si un autre en perd trois.
Les termes à connaître
- any implicite
Un
anyque personne n'a écrit : paramètre non annoté, variable issue d'un module non typé.noImplicitAnyles révèle.- any explicite
Un
anyécrit à la main. Visible, grepable, et donc mesurable — contrairement à l'implicite.- Plancher d'erreurs
Un relevé de référence du nombre d'erreurs par fichier. La construction échoue si un fichier en gagne ; le plancher ne fait que baisser.
- Durcissement progressif
Activer les options de
strictune par une, en traitant les erreurs de chacune avant de passer à la suivante.- unknown
Le remplaçant honnête de
any: il accepte tout en entrée et n'autorise rien en sortie sans affinage.- Zone de contagion
La portée réelle d'un
any: tout ce qu'il touche devientanypar propagation, sans un seul message.
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.