Que sont les index signatures ?

Question

Accepted Answer

Une **index signature** décrit le type de propriétés quand vous ne connaissez pas leurs noms à l'avance — modélisation de dictionnaires/maps où les clés sont dynamiques. ```ts interface StringMap { [key: string]: number; // any string key maps to a number } const scores: StringMap = { math: 90, science: 85 }; scores.history = 70; // ✅ any string key allowed scores.math; // number scores.unknownKey; // number (TS assumes it exists!) — a caveat ``` ## La mise en garde de sécurité Avec une index signature ordinaire, le compilateur suppose que **chaque** clé existe, donc `scores.typo` est typé comme `number` même s'il est en réalité `undefined` à l'exécution. L'activation de `noUncheckedIndexedAccess` corrige cela : ```ts // with noUncheckedIndexedAccess: true scores.math; // number | undefined → forces you to handle the missing case ``` ## Combinaison de clés fixes et dynamiques ```ts interface Config { name: string; // known property [key: string]: string | number; // plus arbitrary extra keys } ``` Toutes les propriétés nommées doivent être assignables au type de valeur de l'index signature. ## Record est souvent plus propre ```ts type Scores = Record; // same as the index signature type Roles = Record<"admin" | "user", boolean>; // constrained keys ``` `Record` est le raccourci idiomatique et supporte une union de clés restreinte, ce qu'une simple `[key: string]` ne peut pas. ## Pourquoi c'est important Les index signatures modélisent les objets véritablement à clés dynamiques (tables de recherche, caches, maps JSON analysées). Connaissez la mise en garde de sécurité (`noUncheckedIndexedAccess`) et préférez `Record` pour la lisibilité — et préférez une `Map` quand les clés sont vraiment ouvertes et que vous voulez une vraie sémantique d'itération/taille.