Formations — 1 037 leçons en français

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 return et throw utiles au typage, pas seulement à la logique.

Garde `typeof`

Le test qui distingue les primitifs. TypeScript connaît les sept résultats possibles de typeof et affine en conséquence. Il ne distingue pas null de object, parce que JavaScript ne le fait pas.

Garde `in`

"cle" in objet affine vers les membres qui déclarent cle dans 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) retire null, undefined — et aussi "", 0, 0n, NaN et false, 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.

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.