Enum no TypeScript: Numeric e String 2026

// Numeric enum - valores começam em 0
enum Direction {
  Up,    // 0
  Down,  // 1
  Left,  // 2
  Right, // 3
}

// Você pode definir o valor inicial
enum HttpStatus {
  OK = 200,
  Created = 201,
  BadRequest = 400,
  NotFound = 404,
  ServerError = 500,
}

function handleResponse(status: HttpStatus) {
  if (status === HttpStatus.OK) {
    console.log("Tudo certo!");
  }
}

handleResponse(HttpStatus.OK); // funciona
// handleResponse(999); // ERRO! não faz parte do enum

// String enum - cada membro tem valor string
enum OrderStatus {
  Pending = "PENDING",
  Processing = "PROCESSING",
  Shipped = "SHIPPED",
  Delivered = "DELIVERED",
  Cancelled = "CANCELLED",
}

interface Order {
  id: number;
  status: OrderStatus;
  total: number;
}

const order: Order = {
  id: 1,
  status: OrderStatus.Pending,
  total: 299.90,
};

// No console: { id: 1, status: "PENDING", total: 299.9 }
// Muito mais legível que ver o número 0

// Const enum - desaparece na compilação
const enum Color {
  Red = "RED",
  Green = "GREEN",
  Blue = "BLUE",
}

const cor = Color.Red;
// No JavaScript compilado: const cor = "RED";
// O enum some completamente. Só fica o valor inline.

// Reverse mapping - só funciona com numeric enums
enum Role {
  Admin,  // 0
  User,   // 1
  Guest,  // 2
}

console.log(Role.Admin);  // 0
console.log(Role[0]);     // "Admin" (reverse mapping)
console.log(Role[1]);     // "User"

// Abordagem com enum
enum Theme {
  Light = "light",
  Dark = "dark",
  System = "system",
}

// Abordagem com union type (mais leve)
type Theme2 = "light" | "dark" | "system";

// As duas funcionam como tipo
function setTheme(theme: Theme) { /* ... */ }
function setTheme2(theme: Theme2) { /* ... */ }

// Diferença: enum gera JavaScript, union não
// Union é só tipagem - desaparece 100% na compilação

// Quando enum ganha:
// - Precisa iterar sobre os valores
// - Quer reverse mapping
// - Valores são usados em runtime (switch, comparação)

// Quando union ganha:
// - Lista simples, poucas opções
// - Bundle size importa
// - Só precisa de checagem de tipo