ما الذي تفعله تأكيدات `as const`؟

Question

Accepted Answer

`as const` هو **تأكيد const** يخبر TypeScript بالاستدلال على النوع **الأكثر تحديداً (حرفي)، قابل للقراءة بشكل عميق** لقيمة ما، بدلاً من توسيعها.

```ts
// without as const — widened, mutable
let a = "up";            // type: string
const obj = { x: 1 };     // type: { x: number }
const arr = [1, 2];       // type: number[]

// with as const — narrow literals, readonly
const b = "up" as const;          // type: "up"
const obj2 = { x: 1 } as const;    // type: { readonly x: 1 }
const arr2 = [1, 2] as const;      // type: readonly [1, 2] (a tuple!)
```

تفعل ثلاثة أشياء: لا توسع *أي شيء* (تحافظ على القيم الحرفية)، تجعل كل شيء `readonly`، وتحول المصفوفات إلى **tuples**.

## لماذا هو مفيد جداً

**اشتقاق نوع اتحاد من قائمة القيم (مصدر حقيقة واحد):**

```ts
const ROLES = ["admin", "editor", "viewer"] as const;
type Role = typeof ROLES[number]; // "admin" | "editor" | "viewer"
// add a role to the array → the union updates automatically
```

**الحفاظ على الأنواع الحرفية للإعدادات/الحالة:**

```ts
const action = { type: "INCREMENT", by: 1 } as const;
// action.type is "INCREMENT" (a literal), so it works in discriminated unions
// without as const it'd be `string`, breaking narrowing
```

## لماذا يهم

`as const` يربط بين قيم وقت التشغيل والأنواع الدقيقة.

يتيح لك تحديد البيانات مرة واحدة (مصفوفة/كائن) واشتقاق أنواع حرفية دقيقة منها — لا غنى عنها لأنواع الإجراءات وخرائط المسارات والإعدادات وأي علامة اتحاد مميزة يجب أن تبقى حرفية بدلاً من التوسع إلى `string`.