Accueil › TypeScript › Inférence sous contrainte
Inférence sous contrainte
Contraintes et inférenceintermediaire
Une contrainte ne fait pas que restreindre : elle guide l'inférence.
Conserver le littéral
function sans<T>(mode: T): T { return mode; }
function avec<T extends string>(mode: T): T { return mode; }
sans("sombre"); // string — élargi
avec("sombre"); // "sombre" — conservé
C'est l'usage le plus fréquent d'une contrainte au quotidien, et il dispense
l'appelant d'écrire as const à chaque appel.
Le cas pratique
function creerEvenements<T extends string>(noms: readonly T[]): Record<T, () => void>
const e = creerEvenements(["ouvrir", "fermer"]);
e.ouvrir(); // ✅
e.quitter(); // ❌ TS2339
Sans la contrainte, T vaudrait string et le résultat serait
Record<string, () => void> — c'est-à-dire aucune vérification.
Le paramètre de type const
function configurer<const T>(options: T): T
configurer({ mode: "sombre" }); // { readonly mode: "sombre" }
const entre chevrons demande au compilateur de ne pas élargir l'argument,
sans qu'on ait à écrire as const à l'appel. C'est le mécanisme à préférer
dès qu'une bibliothèque veut préserver la forme exacte de ce qu'on lui passe.
Le repli sur la contrainte
function f<T extends { id: string }>(): T
const x = f(); // T = { id: string }
Quand rien ne permet de déduire T, le compilateur retient la contrainte.
Le code compile et toute la précision est perdue, en silence.
Les termes à connaître
- Inférence contrainte
Quand un paramètre de type est contraint, le compilateur déduit un type plus précis : la contrainte lui dit quelle forme chercher.
- Conservation du littéral
T extends stringconserve le type littéral là où un paramètrestringl'aurait élargi. C'est l'usage le plus courant d'une contrainte.- Paramètre de type const
<const T>demande au compilateur de ne pas élargir l'argument, sans qu'on écriveas constà l'appel.- Repli sur la contrainte
Quand aucun candidat ne peut être déduit, le compilateur retient la contrainte elle-même. D'où des inférences qui paraissent sorties de nulle part.
- Ordre de résolution
Les paramètres de type se résolvent dans l'ordre où leurs sites d'inférence sont rencontrés. Un paramètre contraint par un autre doit venir après lui.
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.