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 Test l'union des clés deT. Pour{ nom: string; age: number }, c'est"nom" | "age".- Accès indexé
T[K]est le type de la propriétéKdeT. 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"]donnestring | number: l'accès indexé se distribue sur une union de clés.- keyof sur une signature d'index
keyof Record<string, V>vautstring | number— lenumbersurprend, et il vient de ce que les clés numériques sont converties en chaînes.
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.