Was sind index signatures?

Question

Accepted Answer

Eine **index signature** beschreibt den Typ von Eigenschaften, wenn Sie deren Namen vorher nicht kennen — modelliert Wörterbücher/Maps, bei denen Schlüssel dynamisch sind. ```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 ``` ## Sicherheitsvorbehalt Bei einer einfachen index signature geht der Compiler davon aus, dass **jeder** Schlüssel existiert, daher wird `scores.typo` als `number` typisiert, auch wenn es zur Laufzeit tatsächlich `undefined` ist. Aktivieren von `noUncheckedIndexedAccess` behebt dies: ```ts // with noUncheckedIndexedAccess: true scores.math; // number | undefined → forces you to handle the missing case ``` ## Kombinieren von festen und dynamischen Schlüsseln ```ts interface Config { name: string; // known property [key: string]: string | number; // plus arbitrary extra keys } ``` Alle benannten Eigenschaften müssen dem Werttyp der index signature zuweisbar sein. ## Record ist oft übersichtlicher ```ts type Scores = Record; // same as the index signature type Roles = Record<"admin" | "user", boolean>; // constrained keys ``` `Record` ist die idiomatische Kurzform und unterstützt eine eingeschränkte Schlüssel-Union, was ein einfaches `[key: string]` nicht kann. ## Warum es wichtig ist Index signatures modellieren echte dynamisch schlüsselbasierte Objekte (Nachschlagetabellen, Caches, geparste JSON-Maps). Kennen Sie den Sicherheitsvorbehalt (`noUncheckedIndexedAccess`) und bevorzugen Sie `Record` aus Gründen der Lesbarkeit — und bevorzugen Sie `Map`, wenn Schlüssel wirklich offen sind und Sie echte Iterations-/Größungssemantik wünschen.