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
anyaccepte tout, est acceptée partout, et toute expression qui la touche devientanyà 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, etany, 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û mettreanyfaute 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 ununknownen type utilisable, et c'est du code qui s'exécute réellement.
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.