Formations — 1 037 leçons en français

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 any que personne n'a écrit : paramètre non annoté, variable issue d'un module non typé. noImplicitAny les 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 strict une 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 devient any par propagation, sans un seul message.

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.