Mik az index szignatúrák?

Question

Accepted Answer

Az **index szignatúra** leírja a tulajdonságok típusát, ha előzetesen nem ismered azok nevét — szótárak/térképek modellezésére szolgál, ahol a kulcsok dinamikusak. ```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 ``` ## A biztonsági figyelmeztetés Egy sima index szignatúrával a fordító azt feltételezi, hogy **minden** kulcs létezik, így a `scores.typo` `number` típusúként van tipizálva, még akkor is, ha valójában `undefined` futási időben. A `noUncheckedIndexedAccess` engedélyezése ezt kijavítja: ```ts // with noUncheckedIndexedAccess: true scores.math; // number | undefined → forces you to handle the missing case ``` ## Rögzített és dinamikus kulcsok kombinálása ```ts interface Config { name: string; // known property [key: string]: string | number; // plus arbitrary extra keys } ``` Az összes nevesített tulajdonságnak hozzárendelhetőnek kell lennie az index szignatúra értéktípusához. ## A Record gyakran tisztább ```ts type Scores = Record; // same as the index signature type Roles = Record<"admin" | "user", boolean>; // constrained keys ``` A `Record` az idiomatikus rövidítés, és támogatja a korlátozott kulcs uniót, amelyet egy sima `[key: string]` nem tud. ## Miért fontos Az index szignatúra valóban dinamikus kulcsú objektumokat modellez (keresési táblázatok, gyorsítótárak, elemzett JSON térképek). Ismerje meg a biztonsági figyelmeztetést (`noUncheckedIndexedAccess`), és az olvashatóság érdekében preferálja a `Record` megoldást — és preferálja a `Map` megoldást, amikor a kulcsok valóban nyitottak, és valódi iteráció/méret szemantikát szeretne.