Accueil › TypeScript › Extraire avec infer
Extraire avec infer
Types conditionnelsavance
infer déclare une variable de type que le compilateur remplit lui-même, par
filtrage de motif. On écrit la forme attendue avec un trou, et on récupère
ce qui bouche le trou.
type Contenu<T> = T extends Array<infer Element> ? Element : never;
type A = Contenu<string[]>; // string
type B = Contenu<Date[]>; // Date
type C = Contenu<number>; // never
infer ne s'écrit que dans la condition, à droite du extends. Ailleurs,
le compilateur signale TS1338 : « "infer" declarations are only permitted in
the "extends" clause of a conditional type ».
C'est le mécanisme derrière ReturnType
Réécrit à la main, sans any :
type MonReturnType<T extends (...args: never[]) => unknown> =
T extends (...args: never[]) => infer R ? R : never;
type R1 = MonReturnType<() => string>; // string
type R2 = MonReturnType<(n: number) => number[]>; // number[]
Une ligne. Parameters est la même chose avec infer P à la place de la
liste d'arguments, et le motif rend un tuple.
Et derrière Awaited
type MonAwaited<T> = T extends Promise<infer V> ? MonAwaited<V> : T;
type P1 = MonAwaited<Promise<string>>; // string
type P2 = MonAwaited<Promise<Promise<number>>>; // number
type P3 = MonAwaited<string>; // string
La récursion déballe les promesses imbriquées. La branche fausse rend T tel
quel, ce qui fait de ce type une opération idempotente : l'appliquer deux
fois ne change rien. Le vrai Awaited de la bibliothèque standard est plus
long parce qu'il gère aussi les objets munis d'un then sans être des
promesses.
Plusieurs infer dans un motif
type Decoupe<T> = T extends `${infer Gauche}:${infer Droite}` ? [Gauche, Droite] : never;
type D = Decoupe<"port:8080">; // ["port", "8080"]
Les termes à connaître
- infer
Un mot-clé utilisable uniquement dans la condition d'un type conditionnel. Il déclare une variable de type que le compilateur remplit par filtrage de motif.
- Filtrage de motif
Le mécanisme d'
infer: on écrit la forme attendue avec un trou, et le compilateur déduit ce qui remplit le trou.- ReturnType
Le type utilitaire qui extrait le type de retour d'une fonction. Écrit avec un seul
infer.- Awaited
Le type utilitaire qui déballe une promesse, récursivement. Il gère aussi les objets munis d'un
then.- Position de contre-variance
La place des paramètres d'une fonction. Plusieurs candidats y produisent une intersection, là où ailleurs ils produisent une union.
- infer contraint
infer X extends string— depuis TypeScript 4.7, une variable inférée peut porter une contrainte, ce qui écarte les cas non conformes.
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.