ما هي enums ومتى يجب عليك استخدامها؟

Question

Accepted Answer

يُعرّف **enum** مجموعة من الثوابت المسماة. TypeScript يدعم enum رقمي و string enum.

```ts
enum Direction { Up, Down, Left, Right } // numeric: Up=0, Down=1, ...
Direction.Up;        // 0
Direction[0];        // "Up" — numeric enums have a reverse mapping

enum Status {        // string enum — more readable values
  Active = "ACTIVE",
  Inactive = "INACTIVE",
}
Status.Active;       // "ACTIVE"
```

## تحذير: enums تُنتج كود runtime

على عكس معظم أنواع TypeScript (التي تختفي وقت الترجمة)، `enum` عادية تصدر كائن JavaScript إلى bundle الخاص بك. لهذا السبب يفضل العديد من الفرق **union من string literals** بالإضافة إلى `as const`، وهي على المستوى النوعي فقط:

```ts
// often preferred — zero runtime cost, easy to read in logs
const Status = { Active: "ACTIVE", Inactive: "INACTIVE" } as const;
type Status = typeof Status[keyof typeof Status]; // "ACTIVE" | "INACTIVE"

// or simply:
type Direction = "up" | "down" | "left" | "right";
```

## const enum

```ts
const enum E { A, B } // inlined at compile time — no runtime object, but has tooling caveats
```

## لماذا هذا مهم

تعطي enums أسماء ذات معنى لمجموعات ثابتة (حالات، أدوار، اتجاهات) وتجمعها تحت namespace واحد.

لكن لأنها تصدر كود runtime ولها خصائص غريبة (numeric enums تُفحص بشكل느슨)، فإن TypeScript الحديثة غالبا تفضل **string-literal unions** للحالات البسيطة — فهي أخف وتتسلسل بشكل طبيعي.

استخدم enums عندما تريد namespacing أو reverse mapping.