Kas yra indeksų parašai (index signatures)?

Question

Accepted Answer

**Indekso parašas** aprašo savybių tipą, kai iš anksto nežinote jų vardų — modeliuoja žodynus/žemėlapius, kur raktai yra dinaminiai. ```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 ``` ## Saugumo įspėjimas Su paprastuoju indekso parašu, kompiliatorius daro prielaidą, kad **kiekvienas** raktas egzistuoja, todėl `scores.typo` yra vertinamas kaip `number` net jei vykdymo metu tai iš tikrųjų `undefined`. `noUncheckedIndexedAccess` įjungimas tai pataisys: ```ts // with noUncheckedIndexedAccess: true scores.math; // number | undefined → forces you to handle the missing case ``` ## Fiksuotų ir dinaminių raktų derinimas ```ts interface Config { name: string; // known property [key: string]: string | number; // plus arbitrary extra keys } ``` Visos pavadintosios savybės turi būti priskirtos indekso parašo reikšmės tipui. ## Record dažnai yra švaresnis ```ts type Scores = Record; // same as the index signature type Roles = Record<"admin" | "user", boolean>; // constrained keys ``` `Record` yra idiomine santrumpa ir palaiko apribotą raktų sąjungą, kurią negali `[key: string]`. ## Kodėl tai svarbu Indekso parašai modeliuoja tikrai dinaminiais raktais pagrįstus objektus (peržvalgos lenteles, podėlius, analizuotus JSON žemėlapius). Žinokite saugumo įspėjimą (`noUncheckedIndexedAccess`) ir pirmenybę teikite `Record` skaitomumui — ir pirmenybę teikite `Map` kai raktai yra visiškai atversti ir norite tikros iteracijos/dydžio semantikos.