Formations — 1 037 leçons en français

Accueil › TypeScript › Prouver l'exhaustivité avec never

Prouver l'exhaustivité avec never

Unions et affinagedebutant

Un switch complet aujourd'hui est un switch incomplet demain. L'astuce consiste à demander au compilateur de le surveiller.

type Forme =
  | { sorte: "cercle"; rayon: number }
  | { sorte: "carre"; cote: number };

function aire(f: Forme): number {
  switch (f.sorte) {
    case "cercle": return Math.PI * f.rayon ** 2;
    case "carre":  return f.cote ** 2;
    default: {
      const _exhaustif: never = f;   // compile : l'union est épuisée
      return 0;
    }
  }
}

Ajoutez une variante, et le default cesse de compiler :

type Forme =
  | { sorte: "cercle"; rayon: number }
  | { sorte: "carre"; cote: number }
  | { sorte: "triangle"; base: number; hauteur: number };

// dans aire(), au niveau du default :
// TS2322: Type '{ sorte: "triangle"; base: number; hauteur: number; }' is not
// assignable to type 'never'.

Pourquoi ça marche

never est le type sans aucune valeur. Rien ne lui est affectable. Dans le default d'un switch qui a épuisé tous les membres, il ne reste aucun membre possible : le type de f est never, et l'affectation passe. Dès qu'un membre survit, l'affectation est refusée — et le message nomme la variante oubliée.

L'oubli devient une erreur de compilation, visible par celui qui ajoute la variante, et non un undefined découvert par un utilisateur.

Les termes à connaître

`never`

Le type sans aucune valeur. Rien ne lui est affectable, et lui est affectable à tout. C'est l'ensemble vide du système de types.

Exhaustivité

La propriété d'un aiguillage qui traite tous les membres d'une union. Sans preuve, elle est vraie le jour où on l'écrit et fausse le jour où quelqu'un ajoute une variante.

Union épuisée

Ce qui reste d'une union après avoir éliminé tous ses membres : never. C'est ce que vaut la variable dans le default d'un switch complet.

Garde d'exhaustivité

La ligne const _: never = x; placée dans le cas par défaut. Elle compile tant que l'union est épuisée, et produit TS2322 dès qu'un membre est oublié.

`assertNever`

La même idée sous forme de fonction : function assertNever(x: never): never { throw … }. Elle ajoute une erreur à l'exécution pour les données inattendues venues de l'extérieur.

Erreur à la compilation plutôt qu'à l'exécution

Tout l'enjeu : l'oubli d'un cas devient un échec de build visible par celui qui ajoute la variante, au lieu d'un undefined découvert en production.

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.