Accueil › TypeScript › Types récursifs, et leur coût
Types récursifs, et leur coût
Types mappés et littéraux de gabaritavance
Un Partial ne descend pas.
type Config = { serveur: { hote: string; port: number } };
type P = Partial<Config>;
// { serveur?: { hote: string; port: number } }
// ^ hote et port restent obligatoires
La version profonde est récursive.
type DeepPartial<T> = { [K in keyof T]?: DeepPartial<T[K]> };
Ce qu'elle casse
type Mauvais = DeepPartial<{
tags: string[];
rappel: () => void;
creeLe: Date;
}>;
// tags?: (string | undefined)[] — chaque élément devient optionnel
// rappel?: {} — la signature d'appel disparaît
// creeLe?: { getTime?: () => number; … } — toutes les méthodes optionnelles
Les cas d'arrêt
type NePasToucher = Date | RegExp | Map<unknown, unknown> | Set<unknown>;
type DeepPartial<T> =
T extends Function ? T
: T extends NePasToucher ? T
: T extends readonly (infer E)[] ? readonly DeepPartial<E>[]
: T extends object ? { [K in keyof T]?: DeepPartial<T[K]> }
: T;
L'ordre des branches est la partie qui compte : une fonction est un objet,
un tableau est un objet. Tester object en premier avale tout le reste.
Les termes à connaître
- Type récursif
Un alias de type qui se référence lui-même. Autorisé depuis TypeScript 3.7 derrière un objet, un tableau ou une union.
- `DeepPartial`
Un
Partialqui descend dans les objets imbriqués. Absent de la bibliothèque standard, et piégeux à écrire.- Cas d'arrêt
La condition qui empêche la récursion de descendre dans un type qu'il ne faut pas transformer : fonction, tableau,
Date,Map.- Type primitif
string,number,boolean,bigint,symbol,null,undefined. Un mappage appliqué à l'un d'eux produit un type inutilisable.- Limite de profondeur
Le compilateur abandonne au-delà d'une cinquantaine de niveaux, avec
TS2589— « Type instantiation is excessively deep and possibly infinite ».- Dette de compilation
Le coût en temps de compilation d'un type profond, payé à chaque édition dans l'éditeur et non à l'exécution.
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.