Ce sunt semnăturile de index?

Question

Accepted Answer

O **semnătură de index** descrie tipul proprietăților atunci când nu cunoașteți numele acestora în avans — modelând dicționare/hărți în care cheile sunt dinamice. ```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 ``` ## Avertismentul de siguranță Cu o semnătură de index simplă, compilatorul presupune că **fiecare** cheie există, deci `scores.typo` este tipizat ca `number` chiar dacă este de fapt `undefined` la runtime. Activarea `noUncheckedIndexedAccess` remediază acest lucru: ```ts // with noUncheckedIndexedAccess: true scores.math; // number | undefined → forces you to handle the missing case ``` ## Combinarea cheilor fixe și dinamice ```ts interface Config { name: string; // known property [key: string]: string | number; // plus arbitrary extra keys } ``` Todas as propriedades nomeadas trebuie să fie atribuibile tipului de valoare al semnăturii de index. ## Record este adesea mai curat ```ts type Scores = Record; // same as the index signature type Roles = Record<"admin" | "user", boolean>; // constrained keys ``` `Record` este prescurtarea idiomatică și acceptă o uniune de chei restricționată, ceea ce un simplu `[key: string]` nu poate face. ## De ce este important Semnăturile de index modelează obiecte cu chei cu adevărat dinamice (tabele de căutare, cache-uri, hărți JSON analizate). Cunoaștere avertismentul de siguranță (`noUncheckedIndexedAccess`) și preferă `Record` pentru lizibilitate — și preferă un `Map` atunci când cheile sunt cu adevărat deschise și doriți semantica reală de iterație/dimensiune.