X'inhu l-indiċi tas-sinjatūri (index signatures)?

Question

Accepted Answer

Sinjaturi tal-**indiċi** tiddeskrivi t-tip ta' proprjetajiet meta ma tkunx taf l-ismijiet tagħhom minn qabel — timmudella dizzjonari/mapep fejn il-ċwievet huma dinamiċi. ```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 ``` ## L-avvertenza dwar is-sigurtà B'sinjaturi tal-indiċi ordinarja, il-kompiler jassumi li **kull** ċavetta teżisti, għalhekk `scores.typo` hija ttipizzata bħala `number` ankeħ jekk hija tassew `undefined` fil-ħin tal-eżekuzzjoni. L-attivazzjoni ta' `noUncheckedIndexedAccess` iċ-ċ Corrett: ```ts // with noUncheckedIndexedAccess: true scores.math; // number | undefined → forces you to handle the missing case ``` ## Il-kombinazzjoni ta' ċwievet fissi u dinamiċi ```ts interface Config { name: string; // known property [key: string]: string | number; // plus arbitrary extra keys } ``` L-proprjetajiet bl-isem kollha għandhom ikunu assenjabbli għat-tip ta' valur tas-sinjaturi tal-indiċi. ## Record ħafna drabi huwa naddaf ```ts type Scores = Record; // same as the index signature type Roles = Record<"admin" | "user", boolean>; // constrained keys ``` `Record` hija l-abbrevjazzjoni idiomatika u tappoġġja unjoni ta' ċwievetat ristretti, li `[key: string]` ordinarja ma tistax. ## Għaliex dan huwa importanti Sinjaturet tal-indiċi jimmudellaw oġġetti bi ċwievetat verament dinamiċi (tabelli ta' tfittxija, cache, mapep JSON analizzati). Kun konxju tal-avvertenza dwar is-sigurtà (`noUncheckedIndexedAccess`) u agħti preferenza `Record` għal leġġibilità — u agħti preferenza `Map` meta ċ-ċwievetat huma verament miftuħa u trid is-semantika ta' l-iterazzjoni/daqs vera.