Formations — 1 037 leçons en français

Accueil › TypeScript › ReturnType, Parameters, Awaited

ReturnType, Parameters, Awaited

Les types utilitairesintermediaire

Trois utilitaires extraient des types depuis une fonction ou une promesse. Ils évitent de redéclarer ce qui est déjà écrit quelque part.

function construireFiltre(statut: string, depuis: Date) {
  return { statut, depuis, actif: true };
}

type Filtre = ReturnType<typeof construireFiltre>;
// { statut: string; depuis: Date; actif: boolean }

type Args = Parameters<typeof construireFiltre>;
// [statut: string, depuis: Date]

type PremierArg = Parameters<typeof construireFiltre>[0];
// string

Le typeof est obligatoire : ces utilitaires prennent un type de fonction, et le nom d'une fonction est une valeur. Sans lui, c'est TS2749 : « construireFiltre » fait référence à une valeur, mais est utilisé ici comme un type.

Awaited, pour les fonctions asynchrones

async function chargerClient(id: string) {
  const r = await fetch(`/api/clients/${id}`);
  return (await r.json()) as { id: string; nom: string };
}

type Promesse = ReturnType<typeof chargerClient>;          // Promise<{…}>
type Client = Awaited<ReturnType<typeof chargerClient>>;   // { id; nom }

Awaited<ReturnType<typeof f>> est la composition la plus utilisée de la bibliothèque standard. Elle donne le type des données d'un chargeur sans jamais le redéclarer — la règle de la leçon précédente, appliquée à une fonction.

Les termes à connaître

`ReturnType<F>`

Le type de retour d'un type de fonction. S'applique à un type, donc on écrit presque toujours ReturnType<typeof f>.

`Parameters<F>`

Le tuple des types de paramètres. Parameters<typeof f>[0] nomme le premier paramètre sans le redéclarer.

`Awaited<T>`

Le type qu'une promesse résout, en déballant les promesses imbriquées. Awaited<Promise<Promise<string>>> vaut string.

Type conditionnel avec `infer`

La construction T extends (…) => infer R ? R : never qui extrait un type d'une position. C'est de quoi ces trois utilitaires sont faits.

`NonNullable<T>`

Retire null et undefined d'une union. Défini par T & {} depuis TypeScript 4.8.

`ConstructorParameters<C>`

Le tuple des paramètres d'un constructeur. Il faut typeof MaClasse, pas MaClasse : la classe comme valeur, pas le type de ses instances.

Surcharge

Plusieurs signatures pour une même fonction. ReturnType et Parameters ne retiennent que la dernière — une limite à connaître.

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.