Apakah tanda tangan indeks (index signatures)?

Question

Accepted Answer

Sebuah **tanda tangan indeks** menggambarkan jenis sifat ketika Anda tidak mengetahui nama mereka sebelumnya — memodelkan kamus/peta 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 keselamatan Dengan tanda tangan indeks biasa, kompiler menganggap **setiap** kunci ada, jadi `scores.typo` diketik sebagai `number` meskipun sebenarnya `undefined` pada 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 sifat yang dinamai harus dapat ditugaskan ke jenis nilai tanda tangan indeks. ## Record sering lebih bersih ```ts type Scores = Record; // same as the index signature type Roles = Record<"admin" | "user", boolean>; // constrained keys ``` `Record` adalah singkatan idiomatis dan mendukung penyatuan kunci terbatas, yang tidak dapat dilakukan oleh `[key: string]` biasa. ## Mengapa ini penting Tanda tangan indeks memodelkan objek dengan kunci yang benar-benar dinamis (tabel pencarian, cache, peta JSON yang diurai). Ketahui peringatan keselamatan (`noUncheckedIndexedAccess`) dan lebih suka `Record` untuk keterbacaan — dan lebih suka `Map` ketika kunci benar-benar terbuka dan Anda menginginkan semantik iterasi/ukuran yang sebenarnya.