Formations — 1 037 leçons en français

Accueil › TypeScript › any, unknown et never

any, unknown et never

Les types de basedebutant

Trois types se tiennent aux extrémités du système. Les confondre coûte cher.

let a: any = 12;
a.toUpperCase();        // accepté, puis TypeError à l'exécution

let u: unknown = 12;
u.toUpperCase();        // TS18046: 'u' is of type 'unknown'.
if (typeof u === "string") u.toUpperCase();   // d'accord

function abandonner(message: string): never {
  throw new Error(message);                   // ne rend jamais la main
}

any désactive la vérification, et se propage

any n'est pas « un type souple ». C'est l'absence de type. Tout ce qui le touche devient any :

const reponse: any = JSON.parse(texte);
const items = reponse.data.items;      // any
const premier = items[0];              // any
premier.prix.toFixed(2);               // any — aucune erreur signalée

Une seule annotation any à la frontière éteint le contrôle sur toute la chaîne qui en descend. C'est la raison pour laquelle on la traite comme une dette, pas comme un raccourci.

unknown reporte la vérification

unknown accepte les mêmes valeurs qu'any, mais interdit de s'en servir avant d'avoir vérifié. L'erreur se déplace donc du lointain vers l'endroit exact où l'information manque — et la correction est d'écrire la validation.

never est le type sans valeur

Aucune valeur n'habite never. C'est pourquoi il annote une fonction qui lève toujours, et pourquoi il sert à prouver qu'un aiguillage est complet.

Les termes à connaître

`any`

Le type qui désactive la vérification. Une valeur any accepte tout, est acceptée partout, et toute expression qui la touche devient any à son tour : il se propage.

`unknown`

Le type de « une valeur, dont je ne sais rien ». Il accepte tout, comme any, mais ne s'utilise qu'après avoir été réduit. Il reporte la vérification sans l'abandonner.

`never`

Le type sans aucune valeur. Il annote ce qui ne rend jamais la main, il est le résultat d'une union vide, et il sert à prouver l'exhaustivité d'un aiguillage.

Type supérieur (top type)

Un type auquel tout est affectable. TypeScript en a deux : unknown, qui est sûr, et any, qui l'est au prix de toute vérification.

Type inférieur (bottom type)

Un type affectable à tout, parce qu'il n'a aucune valeur à produire. C'est never, et c'est ce qui le rend utilisable comme preuve.

`noImplicitAny`

L'option, incluse dans strict, qui signale les endroits où TypeScript a dû mettre any faute d'information : TS7006, « Parameter 'x' implicitly has an 'any' type ».

Garde de type

Une fonction qui renvoie x is T. C'est le passage obligé pour transformer un unknown en type utilisable, et c'est du code qui s'exécute réellement.

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.