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 ledefaultd'unswitchcomplet.- 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
undefineddécouvert en production.
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.