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.
unknowndit 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.
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.