Wat zijn index signatures?

Question

Accepted Answer

Een **index signature** beschrijft het type van eigenschappen wanneer je hun namen van tevoren niet kent — modelleert dictionaries/maps waarbij sleutels dynamisch zijn. ```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 ``` ## Waarom het belangrijk is Met een gewone index signature neemt de compiler aan dat **elke** sleutel bestaat, dus `scores.typo` wordt getypeerd als `number` hoewel het bij uitvoering eigenlijk `undefined` is. Het inschakelen van `noUncheckedIndexedAccess` lost dit op: ```ts // with noUncheckedIndexedAccess: true scores.math; // number | undefined → forces you to handle the missing case ``` ## Vaste en dynamische sleutels combineren ```ts interface Config { name: string; // known property [key: string]: string | number; // plus arbitrary extra keys } ``` Alle benoemde eigenschappen moeten toewijsbaar zijn aan het waardetype van de index signature. ## Record is vaak netter ```ts type Scores = Record; // same as the index signature type Roles = Record<"admin" | "user", boolean>; // constrained keys ``` `Record` is de idiomatische afkorting en ondersteunt een beperkte sleutel-union, wat gewoon `[key: string]` niet kan. ## Waarom dit van belang is Index signatures modelleren objecten met echt dynamische sleutels (opzoektabellen, caches, geparste JSON-maps). Ken de veiligheidskaveat (`noUncheckedIndexedAccess`) en geef de voorkeur aan `Record` voor leesbaarheid — en geef de voorkeur aan `Map` wanneer sleutels echt open zijn en je echte iteratie-/groottesemantiek wilt.