Formations — 1 037 leçons en français

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 Partial qui 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.

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.