Formations — 1 037 leçons en français

Accueil › TypeScript › Pick, Omit et Record

Pick, Omit et Record

Les types utilitairesintermediaire

Ces trois utilitaires agissent sur l'ensemble des clés — contrairement à Partial et Readonly, qui n'en changent aucune.

type Client = {
  id: number;
  nom: string;
  email: string;
  motDePasse: string;
};

type Apercu = Pick<Client, "id" | "nom">;
// { id: number; nom: string }

type ClientPublic = Omit<Client, "motDePasse">;
// { id: number; nom: string; email: string }

type ParId = Record<string, Client>;
// { [cle: string]: Client }

Pick liste ce qu'on garde, Omit liste ce qu'on jette. Le choix entre les deux est une décision de conception : avec Pick, un champ ajouté à Client n'apparaît pas dans le type dérivé ; avec Omit, il apparaît.

Pour une réponse d'API, Omit est risqué — un champ sensible ajouté plus tard fuite automatiquement. Pour une vue, Pick demande une mise à jour manuelle à chaque évolution.

L'asymétrie qu'il faut connaître

type A = Pick<Client, "telephone">;   // ❌ TS2344 : « telephone » ne satisfait
                                      //    pas la contrainte keyof Client
type B = Omit<Client, "telephone">;   // ✅ accepté, et rend Client inchangé

Pick vérifie que la clé existe. Omit ne vérifie rien. C'est une asymétrie délibérée de la bibliothèque standard, et un piège silencieux : après un renommage, tous vos Omit continuent de compiler en ne retirant plus rien.

Les termes à connaître

`Pick<T, K>`

Garde uniquement les clés listées dans K. K est contraint par extends keyof T : une clé inconnue est une erreur de compilation.

`Omit<T, K>`

Retire les clés listées. K est contraint par extends keyof any, donc une clé inconnue est acceptée sans un mot.

`Record<K, V>`

Un objet dont les clés sont K et les valeurs V. Record<string, number> est un dictionnaire ; Record<Statut, string> est une table exhaustive.

`Exclude<U, V>`

Retire d'une union les membres affectables à V. C'est l'utilitaire sur lequel Omit est construit.

Table exhaustive

Un Record dont les clés sont une union de littéraux. Ajouter un membre à l'union casse la compilation partout où la table est déclarée — l'effet recherché.

Index implicite

Ce que Record<string, V> produit : l'accès par n'importe quelle clé est permis et typé V, même si la clé est absente. noUncheckedIndexedAccess corrige cela.

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.