Accueil › TypeScript › Affiner : typeof, in, instanceof, vérité
Affiner : typeof, in, instanceof, vérité
Unions et affinagedebutant
Affiner, c'est réduire une union à l'intérieur d'une branche. Vous écrivez un test ordinaire ; TypeScript le lit et change le type.
function formater(x: string | number) {
if (typeof x === "string") {
return x.toUpperCase(); // ici x est string
}
return x.toFixed(2); // ici x est number
}
Aucune annotation, aucune assertion. Le même x a deux types différents à
deux endroits du corps, parce que le compilateur suit le flux de contrôle.
Les quatre gardes du quotidien
// typeof — pour les primitifs
if (typeof x === "string") { /* x: string */ }
// in — pour la présence d'une clé
if ("siret" in p) { /* p: Client */ }
// instanceof — pour les classes
if (e instanceof Error) { /* e: Error */ }
// vérité — pour retirer null et undefined… et un peu trop
if (x) { /* x n'est ni null ni undefined */ }
Le piège de la vérité
function etiquette(n: number | null) {
if (!n) return "non renseigné"; // ← 0 passe ici
return `${n} article(s)`;
}
etiquette(0); // "non renseigné" — faux
0, "", 0n, NaN et false sont falsy. Un test de vérité ne distingue
pas « absent » de « nul ». Quand l'union contient null ou undefined,
testez-les nommément : if (n === null), ou if (n == null) pour couvrir les
deux d'un coup.
Les termes à connaître
- Affinage (narrowing)
Le travail du compilateur qui réduit une union à moins de membres à l'intérieur d'une branche, en lisant le test que vous avez écrit. Le type n'est pas le même aux deux endroits du
if.- Flux de contrôle
L'analyse qui suit les chemins d'exécution possibles pour attribuer un type à chaque point du code. C'est elle qui rend
returnetthrowutiles au typage, pas seulement à la logique.- Garde `typeof`
Le test qui distingue les primitifs. TypeScript connaît les sept résultats possibles de
typeofet affine en conséquence. Il ne distingue pasnulldeobject, parce que JavaScript ne le fait pas.- Garde `in`
"cle" in objetaffine vers les membres qui déclarentcledans la branche vraie, et vers ceux qui ne la déclarent pas dans la branche fausse.- Garde `instanceof`
Le test de chaîne de prototypes. Il affine vers une classe, et ne fonctionne donc que sur des objets construits par une classe — jamais sur un objet littéral ni sur un primitif.
- Affinage par vérité
if (x)retirenull,undefined— et aussi"",0,0n,NaNetfalse, qui sont des valeurs légitimes. C'est la source de bogues la plus fréquente de ce chapitre.- Garde de type personnalisée
Une fonction dont le type de retour s'écrit
x is T. Elle rend un test réutilisable, au prix d'une promesse que le compilateur croit sans la vérifier.
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.