ما هي index signatures؟

Question

Accepted Answer

**index signature** تصف نوع الخصائص عندما لا تعرف أسماءها مسبقاً — نمذجة القواميِيس/الخرائط حيث تكون المفاتيح ديناميكية. ```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 ``` ## تحذير الأمان مع index signature عادي، يفترض المترجم أن **كل** مفتاح موجود، لذا `scores.typo` يُكتَب كـ `number` حتى لو كان في الواقع `undefined` في وقت التشغيل. تفعيل `noUncheckedIndexedAccess` يصلح هذا: ```ts // with noUncheckedIndexedAccess: true scores.math; // number | undefined → forces you to handle the missing case ``` ## دمج المفاتيح الثابتة والديناميكية ```ts interface Config { name: string; // known property [key: string]: string | number; // plus arbitrary extra keys } ``` جميع الخصائص المسماة يجب أن تكون قابلة للإسناد إلى نوع قيمة index signature. ## Record غالباً أنظف ```ts type Scores = Record; // same as the index signature type Roles = Record<"admin" | "user", boolean>; // constrained keys ``` `Record` هو الاختصار الاصطلاحي ويدعم اتحاد مفاتيح مقيد، وهو ما لا يستطيعه `[key: string]` عادي. ## لماذا يهم index signatures تنمذج كائنات بمفاتيح حقيقية ديناميكية (جداول البحث، الذاكرة المؤقتة، خرائط JSON المحللة). اعرف تحذير الأمان (`noUncheckedIndexedAccess`) وفضّل `Record` من أجل الوضوح — وفضّل `Map` عندما تكون المفاتيح مفتوحة حقاً وتريد دلالات التكرار/الحجم الحقيقية.