Cosa sono le firme d'indice?

Question

Accepted Answer

Una **firma d'indice** descrive il tipo delle proprietà quando non conosci i loro nomi in anticipo — modellando dizionari/mappe dove le chiavi sono dinamiche. ```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 ``` ## La caveat sulla sicurezza Con una semplice firma d'indice, il compilatore assume che **ogni** chiave esista, quindi `scores.typo` è tipizzata come `number` anche se in realtà è `undefined` a runtime. Abilitare `noUncheckedIndexedAccess` risolve questo: ```ts // with noUncheckedIndexedAccess: true scores.math; // number | undefined → forces you to handle the missing case ``` ## Combinare chiavi fisse e dinamiche ```ts interface Config { name: string; // known property [key: string]: string | number; // plus arbitrary extra keys } ``` Tutte le proprietà nominate devono essere assegnabili al tipo di valore della firma d'indice. ## Record è spesso più pulito ```ts type Scores = Record; // same as the index signature type Roles = Record<"admin" | "user", boolean>; // constrained keys ``` `Record` è la scorciatoia idiomatica e supporta un'unione di chiavi ristretta, cosa che una semplice `[key: string]` non può fare. ## Perché è importante Le firme d'indice modellano oggetti veramente dinamici con chiavi (tabelle di ricerca, cache, mappe JSON parseificate). Conosci la caveat sulla sicurezza (`noUncheckedIndexedAccess`) e preferisci `Record` per la leggibilità — e preferisci una `Map` quando le chiavi sono veramente aperte e vuoi vere semantiche di iterazione/dimensione.