Formations — 1 037 leçons en français

Accueil › TypeScript › Types génériques et structures

Types génériques et structures

Les génériquesintermediaire

Les génériques les plus rentables ne sont pas des fonctions, ce sont des structures.

Le résultat

type Resultat<T> =
  | { statut: "ok"; donnees: T }
  | { statut: "erreur"; message: string };

function afficher(r: Resultat<Client>) {
  if (r.statut === "erreur") return r.message;
  return r.donnees.nom;           // affiné : données présentes
}

La mécanique « ou bien un résultat, ou bien une erreur » ne dépend pas du contenu. Elle s'écrit une fois.

La page

type Page<T> = {
  elements: T[];
  total: number;
  suivante: string | null;
};

Un seul type pour Page<Client>, Page<Facture>, Page<Commande> — et une seule place à corriger si l'API change de forme.

Le défaut

type Reponse<T = unknown> = { statut: number; corps: T };

const r: Reponse = …;
r.corps.nom;                       // ❌ TS18046 : « corps » est de type « unknown »

unknown oblige l'appelant qui n'a pas précisé la forme à valider. any l'aurait laissé écrire n'importe quoi.

La classe conteneur

class Cache<V> {
  private valeurs = new Map<string, V>();

  mettre(cle: string, valeur: V): void {
    this.valeurs.set(cle, valeur);
  }

  lire(cle: string): V | undefined {
    return this.valeurs.get(cle);
  }
}

V apparaît trois fois : à l'entrée, à la sortie, dans l'état. C'est le signe qu'une classe générique est justifiée.

Les termes à connaître

Type générique

Un alias ou une interface paramétré par un type. Il décrit une structure — résultat, page, cache — indépendamment de son contenu.

Paramètre par défaut

<T = unknown>. Permet d'utiliser le type sans argument, et unknown y vaut toujours mieux que any.

Classe générique

Une classe paramétrée par un type. Utile pour un conteneur ; inutile dès que le type n'apparaît qu'une fois.

Conteneur typé

Une structure dont le contenu varie mais dont les opérations sont les mêmes : pile, cache, file, résultat.

Union discriminée générique

La forme la plus utile : { statut: "ok"; donnees: T } | { statut: "erreur"; message: string }. Le contenu dépend de la variante.

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.