Les types utilitaires TypeScript : Partial, Pick, Omit, Record
Partial rend les propriétés facultatives, Pick garde les propriétés que vous nommez, Omit les retire du type et Record associe un type de valeur à un ensemble de clés. Ces quatre types sont fournis par TypeScript et s'utilisent sans import.
Dans une liste de tâches, un formulaire de modification, une carte à l'écran et une liste de libellés ont chacun besoin d'un type différent. Construisons-les à partir du même modèle. Si vous découvrez la syntaxe entre chevrons, commencez par les génériques en TypeScript.
Une tâche comme point de départ
type Etat = "a-faire" | "terminee";
type Tache = {
id: number;
titre: string;
etat: Etat;
details: {
projet: string;
priorite: number;
};
};
const tache: Tache = {
id: 7,
titre: "Relire le chapitre",
etat: "a-faire",
details: { projet: "Cours TypeScript", priorite: 2 },
};Chaque exemple s'ajoute séparément à ce premier bloc. J'ai compilé les extraits avec TypeScript 6.0.3 et exécuté les blocs valides avec Node.js 22.23.5 sous Windows. En fin d'article, les commandes permettent de refaire l'essai.
Partial pour modifier un champ à la fois
Pour renommer la tâche, le formulaire peut envoyer seulement le titre. Partial<Tache> inclurait aussi l'identifiant. On commence donc par définir les champs modifiables avec Pick, puis on les rend facultatifs avec Partial.
type ChampsModifiables = Pick<Tache, "titre" | "etat">;
type Modification = Partial<ChampsModifiables>;
function modifier(tache: Tache, modification: Modification): Tache {
return {
...tache,
titre: modification.titre ?? tache.titre,
etat: modification.etat ?? tache.etat,
};
}
const saisie = { id: 99, titre: "Relire le guide" };
const renommee = modifier(tache, saisie);
console.log(JSON.stringify({ id: renommee.id, titre: renommee.titre, etat: renommee.etat }));
console.log(modifier(tache, {}).titre);{"id":7,"titre":"Relire le guide","etat":"a-faire"}
Relire le chapitreTypeScript accepte ici la variable saisie parce qu'elle fournit un titre du bon type, même si elle contient aussi id. La fonction modifier copie la tâche, puis choisit explicitement les deux valeurs à modifier. L'opérateur ?? garde l'ancienne valeur lorsque le champ est absent. Ici, l'identifiant reste à 7 et l'état reste a-faire. Un objet vide est aussi accepté puisque les deux champs sont facultatifs.
Partial agit au premier niveau. Dans Partial<Tache>, la propriété details devient facultative. Si on la fournit, sa valeur doit toujours contenir projet et priorite. Le compilateur signale ici le champ manquant.
const modification: Partial<Tache> = { details: { priorite: 3 } };error TS2741: Property 'projet' is missing in type '{ priorite: number; }' but required in type '{ projet: string; priorite: number; }'.Pick et Omit pour définir deux vues de la même tâche
Pick<Tache, "titre" | "etat"> décrit les deux propriétés d'une carte. Omit<Tache, "details"> décrit une tâche avec son identifiant, son titre et son état. Choisissez Pick quand la liste des champs à garder est fixe. Si le modèle gagne un champ, il reste absent du type construit avec Pick et apparaît dans celui construit avec Omit, sauf si vous l'excluez aussi.
Une annotation change les propriétés que TypeScript permet de lire via une variable. La valeur JavaScript, elle, reste identique. Regardez les clés affichées par les deux variables annotées.
type Carte = Pick<Tache, "titre" | "etat">;
type TacheSansDetails = Omit<Tache, "details">;
const carte: Carte = tache;
const sansDetails: TacheSansDetails = tache;
console.log(JSON.stringify(Object.keys(carte)));
console.log(JSON.stringify(Object.keys(sansDetails)));["id","titre","etat","details"]
["id","titre","etat","details"]Pour transmettre une carte qui contient uniquement le titre et l'état, fabriquez un nouvel objet avec ces deux champs. C'est la construction JavaScript qui détermine les clés présentes dans la valeur envoyée.
type Carte = Pick<Tache, "titre" | "etat">;
const carte: Carte = { titre: tache.titre, etat: tache.etat };
console.log(JSON.stringify(Object.keys(carte)));["titre","etat"]Record pour donner un libellé à chaque état
Le code stocke "a-faire" ou "terminee". L'écran doit afficher un libellé lisible. Avec Record<Etat, string>, chaque valeur possible d'Etat devient une clé obligatoire dont la valeur doit être une chaîne.
const libelles: Record<Etat, string> = {
"a-faire": "À faire",
terminee: "Terminée",
};
console.log(libelles[tache.etat]);À faireSi vous oubliez terminee, le compilateur le signale avant l'exécution.
const libelles: Record<Etat, string> = { "a-faire": "À faire" };error TS2741: Property 'terminee' is missing in type '{ "a-faire": string; }' but required in type 'Record<Etat, string>'.Avec Record<string, string>, le compilateur n'exige plus les deux clés d'Etat. L'objet vide est accepté. Dans cet exemple, la recherche de a-faire dans cet objet donne undefined à l'exécution. L'option --noUncheckedIndexedAccess, utilisée ici, ajoute undefined au type de cette lecture sur une clé arbitraire.
const libelles: Record<string, string> = {};
const libelle = libelles[tache.etat];
console.log(libelle);undefinedSi vous essayez de traiter directement ce résultat comme une chaîne, cette même option permet au compilateur de signaler le cas absent.
const libelles: Record<string, string> = {};
const libelle: string = libelles[tache.etat];error TS2322: Type 'string | undefined' is not assignable to type 'string'.
Type 'undefined' is not assignable to type 'string'.Quel type choisir ?
| Besoin | Type |
|---|---|
| Rendre les champs modifiables facultatifs | Partial<ChampsModifiables> |
| Garder le titre et l'état pour une carte | Pick<Tache, "titre" | "etat"> |
| Décrire une tâche sans ses détails | Omit<Tache, "details"> |
| Exiger un libellé pour chaque état | Record<Etat, string> |
Pour mettre ces types en pratique, reprenez le modèle de données de la todo-list en TypeScript et définissez les champs que votre formulaire peut modifier.
Rejouer les exemples
Dans un dossier de travail, copiez le premier bloc, puis un seul des exemples suivants dans exemple.ts. La première commande installe le compilateur à la version utilisée ici. Pour un exemple valide, lancez ensuite le fichier JavaScript produit. L'option --ignoreConfig permet de lancer la commande même si le dossier contient déjà un tsconfig.json. Pour un exemple signalé comme fautif, arrêtez-vous au diagnostic du compilateur, affiché en anglais. Les diagnostics ci-dessus reprennent son code et son texte, sans l'emplacement dans le fichier.
npm install --save-exact typescript@6.0.3
npx tsc --ignoreConfig --strict --exactOptionalPropertyTypes --noUncheckedIndexedAccess --noEmitOnError --pretty false --target es2022 --lib es2022,dom --outDir dist exemple.ts
node dist/exemple.jsLes définitions des quatre utilitaires figurent dans le manuel TypeScript de Microsoft, consulté le 21 novembre 2026.