Formations — 1 037 leçons en français

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.

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.