Mitä ovat index signatures?

Question

Accepted Answer

**Index signature** kuvaa ominaisuuksien tyypin, kun et tiedä niiden nimiä etukäteen — mallintaa sanakirjoja/karttoja, joissa avaimet ovat dynaamisia. ```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 ``` ## Turvallisuuden varoitus Tavallisella index signaturella kääntäjä olettaa, että **jokainen** avain on olemassa, joten `scores.typo` on tyypitetty `number`ksi vaikka se on todellisuudessa `undefined` ajon aikana. `noUncheckedIndexedAccess` käyttöönotto korjaa tämän: ```ts // with noUncheckedIndexedAccess: true scores.math; // number | undefined → forces you to handle the missing case ``` ## Kiinteiden ja dynaamisten avainten yhdistäminen ```ts interface Config { name: string; // known property [key: string]: string | number; // plus arbitrary extra keys } ``` Kaikki nimetyt ominaisuudet on voitava määrittää index signaturen arvotyyppiin. ## Record on usein siistimpi ```ts type Scores = Record; // same as the index signature type Roles = Record<"admin" | "user", boolean>; // constrained keys ``` `Record` on idiomatiikka lyhennys ja tukee rajoitettua avain-unionia, jota tavallinen `[key: string]` ei voi. ## Miksi sillä on väliä Index signatuurit mallintavat todella dynaamisia avaimia sisältäviä objekteja (hakutaulukot, välimuistit, jäsennellyt JSON-kartat). Tietää turvallisuuden varoitus (`noUncheckedIndexedAccess`) ja suosi `Record` luettavuuden vuoksi — ja suosi `Map`ia kun avaimet ovat todella avoimia ja haluat todellista iteraation/koon semantiikkaa.