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>>>vautstring.- Type conditionnel avec `infer`
La construction
T extends (…) => infer R ? R : neverqui extrait un type d'une position. C'est de quoi ces trois utilitaires sont faits.- `NonNullable<T>`
Retire
nulletundefinedd'une union. Défini parT & {}depuis TypeScript 4.8.- `ConstructorParameters<C>`
Le tuple des paramètres d'un constructeur. Il faut
typeof MaClasse, pasMaClasse: la classe comme valeur, pas le type de ses instances.- Surcharge
Plusieurs signatures pour une même fonction.
ReturnTypeetParametersne retiennent que la dernière — une limite à connaître.
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.