Co jsou index signatures?

Question

Accepted Answer

**index signature** popisuje typ vlastností, když jejich jména nechcete znát předem — modeluje slovníky/mapy, kde jsou klíče dynamické. ```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 ``` ## Upozornění na bezpečnost Při běžné index signature kompilátor předpokládá, že **každý** klíč existuje, takže `scores.typo` je typizován jako `number` i když je za běhu ve skutečnosti `undefined`. Povolení `noUncheckedIndexedAccess` to opravuje: ```ts // with noUncheckedIndexedAccess: true scores.math; // number | undefined → forces you to handle the missing case ``` ## Kombinování pevných a dynamických klíčů ```ts interface Config { name: string; // known property [key: string]: string | number; // plus arbitrary extra keys } ``` Všechny pojmenované vlastnosti musí být přiřaditelné typu hodnoty index signature. ## Record je často čistší ```ts type Scores = Record; // same as the index signature type Roles = Record<"admin" | "user", boolean>; // constrained keys ``` `Record` je idiomatická zkratka a podporuje omezené sjednocení klíčů, které holá `[key: string]` nemůže. ## Proč na tom záleží Index signatures modelují skutečně dynamicky klíčované objekty (vyhledávací tabulky, mezipaměti, parsované JSON mapy). Znáte varování bezpečnosti (`noUncheckedIndexedAccess`) a preferujte `Record` kvůli čitelnosti — a preferujte `Map`, když jsou klíče skutečně otevřené a chcete skutečnou sémantiku iterace/velikosti.