რა არის ინდექსის ხელმოწერები (index signatures)?

Question

Accepted Answer

**ინდექსის ხელმოწერა** აღწერს თვისებების ტიპს, როდესაც თქვენ არ იცით მათი სახელები წინასწარ — აყალიბებს ლექსიკონებს/რუკებს, სადაც გასაღებები დინამიკური არის. ```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 ``` ## უსაფრთხოების გაფრთხების შენიშვნა ჩვეულებრივი ინდექსის ხელმოწერით, კომპილერი ვარაუდობს, რომ **ყველა** გასაღები არსებობს, ამიტომ `scores.typo` აკრეფილია `number`-ად მაშინაც კი, თუ ის რეალურად `undefined` არის runtime-ში. `noUncheckedIndexedAccess` ჩართვა აღმოფხვრის ამას: ```ts // with noUncheckedIndexedAccess: true scores.math; // number | undefined → forces you to handle the missing case ``` ## ფიქსირებული და დინამიური გასაღებების გაერთიანება ```ts interface Config { name: string; // known property [key: string]: string | number; // plus arbitrary extra keys } ``` ყველა დასახელებული თვისება უნდა იყოს ინდექსის ხელმოწერის მნიშვნელობის ტიპისთვის მინიჭებადი. ## Record ხშირად უფრო깔끔합니다 ```ts type Scores = Record; // same as the index signature type Roles = Record<"admin" | "user", boolean>; // constrained keys ``` `Record` არის იდიომატური მოკლე ხელი და მხარს უჭერს შეზღუდულ გასაղების გაერთიანებას, რომელიც ჩვეულებრივ `[key: string]` არ შეუძლია. ## რატომ აქვს ეს მნიშვნელობა ინდექსის ხელმოწერა აყალიბებს უნივერსალურად დინამიური გასაღებიანი ობიექტებს (ძებნის ცხრილები, cache, parsed JSON რუკები). იცოდეთ უსაფრთხოების გაფრთხების შენიშვნა (`noUncheckedIndexedAccess`) და უპირატეს `Record` წაკითხვადობისთვის — და უპირატეს `Map` როდესაც გასაღებები ნამდვილად ღია და სიმართოვე გაიმეორებლობის/ზომის სემანტიკა გსურთ.