Formations — 1 037 leçons en français

Accueil › TypeScript › Quand ne pas généraliser

Quand ne pas généraliser

Les génériquesintermediaire

Les génériques coûtent à la lecture. Ce coût se paie à chaque lecture, alors que le bénéfice ne se touche qu'au deuxième usage.

La règle des deux occurrences

// ❌ T n'apparaît qu'une fois
function journaliser<T>(x: T): void

// ✅ la même chose, honnête
function journaliser(x: unknown): void

Aucune relation n'est exprimée. Le paramètre complique la signature sans rien garantir.

Le générique de façade

// ❌ un « as T » déguisé
function parser<T>(json: string): T {
  return JSON.parse(json);
}

const c = parser<Client>('{"nom":1}');   // compile, et c.nom est un nombre

// ✅ honnête : l'appelant doit valider
function parser(json: string): unknown

C'est la forme la plus dangereuse, parce qu'elle a l'air typée.

Attendre le deuxième usage

// Premier besoin : un cache de clients
class CacheClients {
  lire(id: string): Client | undefined
}

// Deuxième besoin, trois semaines plus tard : un cache de factures
// → maintenant on généralise, en sachant ce qui varie
class Cache<V> {
  lire(cle: string): V | undefined
}

Avant le deuxième usage, on devine ce qui variera. On devine mal.

Le critère de lisibilité

Si expliquer un type prend plus de deux phrases, il est trop malin.

// ❌ personne ne corrigera ça dans six mois
type Extraire<T, K extends keyof T, V extends T[K] = T[K]> = …

Les termes à connaître

Règle des deux occurrences

Un paramètre de type qui n'apparaît qu'une fois n'exprime aucune relation. unknown dit la même chose, plus clairement.

Générique de façade

Un paramètre de type dont la seule fonction est de faire accepter un as. Il a l'air typé et ne vérifie rien.

Abstraction prématurée

Un type paramétré écrit pour un usage unique, avec des paramètres pour des cas imaginaires. Il coûte plus qu'il ne rapporte.

Coût de lecture

Le temps qu'un lecteur passe à reconstituer ce qu'un type signifie. Il se paie à chaque lecture, pas une fois à l'écriture.

Deuxième usage

Le signal qui justifie une généralisation. Avant lui, on devine ce qui variera — et on devine mal.

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.