Apa itu index signatures?

Question

Accepted Answer

**Index signature** mendeskripsikan tipe properti ketika Anda tidak tahu namanya sebelumnya — memodelkan dictionaries/maps di mana kunci bersifat dinamis. ```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 ``` ## Peringatan keamanan Dengan index signature biasa, compiler mengasumsikan **setiap** kunci ada, jadi `scores.typo` diketik sebagai `number` bahkan jika sebenarnya `undefined` saat runtime. Mengaktifkan `noUncheckedIndexedAccess` memperbaikinya: ```ts // with noUncheckedIndexedAccess: true scores.math; // number | undefined → forces you to handle the missing case ``` ## Menggabungkan kunci tetap dan dinamis ```ts interface Config { name: string; // known property [key: string]: string | number; // plus arbitrary extra keys } ``` Semua named properties harus dapat diberikan ke tipe nilai index signature. ## Record sering lebih bersih ```ts type Scores = Record; // same as the index signature type Roles = Record<"admin" | "user", boolean>; // constrained keys ``` `Record` adalah shorthand idiomatik dan mendukung restricted key union, yang tidak bisa dilakukan bare `[key: string]`. ## Mengapa ini penting Index signatures memodelkan objek dengan kunci yang benar-benar dinamis (lookup tables, caches, parsed JSON maps). Ketahui caveat keamanan (`noUncheckedIndexedAccess`) dan lebih suka `Record` untuk readability — dan lebih suka `Map` ketika kunci benar-benar open-ended dan Anda menginginkan semantik iterasi/size yang sebenarnya.