Formations — 1 037 leçons en français

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 string conserve le type littéral là où un paramètre string l'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 écrive as 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.

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.