Formations — 1 037 leçons en français

Accueil › TypeScript › Les littéraux de gabarit

Les littéraux de gabarit

Types mappés et littéraux de gabaritavance

Un littéral de gabarit décrit une forme de chaîne au niveau des types.

type Evenement = `on${string}`;

const a: Evenement = "onClick";      // ✅
const b: Evenement = "click";        // ❌ TS2322 : « "click" » n'est pas assignable à « `on${string}` »

La distribution, qui fait tout l'intérêt

type Champ = "nom" | "age";
type Accesseur = `get${Capitalize<Champ>}`;
// "getNom" | "getAge"

Un trou rempli par une union produit l'union de toutes les combinaisons.

Les quatre intrinsèques

type A = Uppercase<"abc">;        // "ABC"
type B = Lowercase<"ABC">;        // "abc"
type C = Capitalize<"abc">;       // "Abc"
type D = Uncapitalize<"Abc">;     // "abc"

Capitalize ne touche que le premier caractère ; Uppercase touche tout. La confusion produit des getNOMCLIENT.

L'explosion combinatoire

type Taille = "s" | "m" | "l";
type Cote = "haut" | "bas" | "gauche" | "droite";

type Classe = `m-${Cote}-${Taille}`;   // 4 × 3 = 12 membres

Le nombre de membres est le produit des tailles. Deux unions de 50 donnent 2500 types ; trois donnent 125 000, et le compilateur refuse au-delà de 100 000 avec une erreur sur la complexité de l'union.

Les termes à connaître

Littéral de gabarit

Un type écrit entre accents graves avec des trous — `get${string}` — qui décrit une forme de chaîne au niveau des types.

Distribution sur union

Un gabarit dont un trou est une union produit l'union de toutes les combinaisons.

Explosion combinatoire

Le produit des tailles des unions insérées. Deux unions de 10 membres donnent 100 types ; trois en donnent 1000.

`Uppercase` / `Lowercase`

Deux types intrinsèques de la bibliothèque standard qui changent la casse d'un littéral de chaîne.

`Capitalize` / `Uncapitalize`

Deux autres intrinsèques, qui n'agissent que sur le premier caractère.

Inférence par `infer`

Un gabarit peut décomposer une chaîne — T extends `${infer A}-${infer B}` — ce qui en fait un analyseur de chaînes à la compilation.

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.