Formations — 1 037 leçons en français

Accueil › TypeScript › keyof et accès indexé

keyof et accès indexé

Contraintes et inférenceintermediaire

type Client = { nom: string; age: number };

type Cles = keyof Client;          // "nom" | "age"
type Valeur = Client["nom"];       // string

keyof donne les clés comme type. L'accès indexé donne le type d'une propriété.

La signature la plus utile de TypeScript

function lire<T, K extends keyof T>(objet: T, cle: K): T[K] {
  return objet[cle];
}

const c = { nom: "Astra", age: 4 };

lire(c, "nom");                    // string
lire(c, "age");                    // number
lire(c, "taille");                 // ❌ TS2345 : « taille » n'existe pas

Le type de retour dépend de la valeur de l'argument. C'est ce que les génériques permettent et que rien d'autre ne permet.

La distribution sur une union

type Melange = Client["nom" | "age"];     // string | number

L'accès indexé se distribue : chaque membre de l'union de clés donne son type, et le résultat est l'union des types.

Écrire une fonction qui écrit

function ecrire<T, K extends keyof T>(objet: T, cle: K, valeur: T[K]): void {
  objet[cle] = valeur;
}

ecrire(c, "age", 5);               // ✅
ecrire(c, "age", "cinq");          // ❌ TS2345

Trois paramètres de type liés entre eux : c'est la relation qui fait tout le travail.

Le piège d'Object.keys

Object.keys(c);                    // string[] — et non ("nom" | "age")[]

Ce n'est pas un oubli : un objet peut avoir plus de propriétés que son type n'en décrit.

Les termes à connaître

keyof

keyof T est l'union des clés de T. Pour { nom: string; age: number }, c'est "nom" | "age".

Accès indexé

T[K] est le type de la propriété K de T. Combiné à keyof, il relie une clé à son type de valeur.

Clé contrainte

K extends keyof T : la clé passée doit exister dans l'objet. C'est la contrainte la plus utile de TypeScript.

Union distribuée

T["nom" | "age"] donne string | number : l'accès indexé se distribue sur une union de clés.

keyof sur une signature d'index

keyof Record<string, V> vaut string | number — le number surprend, et il vient de ce que les clés numériques sont converties en chaînes.

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.