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.
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.