Czym są enumeracje i kiedy ich używać?

Question

Accepted Answer

**Enum** definiuje zestaw nazwanych stałych. TypeScript ma enumeracje liczbowe i stringowe.

```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"
```

## Zastrzeżenie: enumeracje generują kod w czasie wykonywania

W przeciwieństwie do większości typów TypeScript (które znikają w momencie kompilacji), zwykły `enum` emituje obiekt JavaScript do Twojego pakietu. Dlatego wiele zespołów preferuje **unię literałów stringowych** plus `as const`, która jest czysto na poziomie typów:

```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
```

## Dlaczego to ważne

Enumeracje nadają znaczące nazwy stałym zestawom (stany, role, kierunki) i grupują je w jedną przestrzeń nazw.

Ale ponieważ emitują kod w czasie wykonywania i mają osobliwości (enumeracje liczbowe są słabo sprawdzane), nowoczesny TypeScript często faworyzuje **uniom literałów stringowych** w prostych przypadkach — są lżejsze i serializują się naturalnie.

Używaj enumeracji, gdy chcesz nazw przestrzeni lub mapowania odwrotnego.