Index signature'lar nedir?

Question

Accepted Answer

Bir **index signature**, adlarını önceden bilmediğiniz özeliklerin türünü tanımlar — dinamik anahtarları olan sözlükleri/haritaları modellersiniz. ```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 ``` ## Güvenlik uyarısı Sade bir index signature ile, derleyici **her** anahtarın var olduğunu varsayar, bu nedenle `scores.typo`, çalışma zamanında aslında `undefined` olsa bile `number` olarak yazılır. `noUncheckedIndexedAccess` etkinleştirmek bunu düzeltir: ```ts // with noUncheckedIndexedAccess: true scores.math; // number | undefined → forces you to handle the missing case ``` ## Sabit ve dinamik anahtarları birleştirme ```ts interface Config { name: string; // known property [key: string]: string | number; // plus arbitrary extra keys } ``` Tüm adlandırılmış özellikler, index signature'ın değer türüne atanabilir olmalıdır. ## Record genellikle daha temiz ```ts type Scores = Record; // same as the index signature type Roles = Record<"admin" | "user", boolean>; // constrained keys ``` `Record`, sözcüksel kısa yazı olup kısıtlı anahtar birleşimini destekler; sade `[key: string]` bunu yapamaz. ## Neden önemli Index signature'lar gerçek anlamda dinamik anahtarlı nesneleri (arama tabloları, önbellekler, ayrıştırılan JSON haritaları) modellersiniz. Güvenlik uyarısını (`noUncheckedIndexedAccess`) bilin ve okunabilirlik için `Record` tercih edin — anahtarlar gerçek anlamda açık olduğunda ve gerçek yineleme/boyut anlamsal özelliklerini istediğinizde `Map` tercih edin.