Enumerações: constantes numéricas e de texto

Boas-vindas

Enumerações numéricas

enum Direction {
  Up,    // 0
  Down,  // 1
  Left,  // 2
  Right, // 3
}
console.log(Direction.Up); // 0

Valores numéricos personalizados em enumerações

enum Status {
  Active = 1,
  Inactive, // 2
  Banned = 100,
}

Enumerações de strings

enum Color {
  Red = 'RED',
  Green = 'GREEN',
  Blue = 'BLUE',
}

Usando enumerações em funções

function move(dir: Direction): void {
  console.log('Moving:', Direction[dir]);
}
move(Direction.Up);

Mapeamento reverso (somente numérico)

enum Status { Active = 1, Inactive = 2 }
console.log(Status[1]); // 'Active'
console.log(Status.Active); // 1

Enumerações constantes

const enum Axis { X, Y, Z }
const a = Axis.X; // compiled to: const a = 0;

Enumerações versus união de literais

// Enum
enum Dir { Up = 'UP', Down = 'DOWN' }

// Union literal (preferred by many)
type Dir2 = 'UP' | 'DOWN';

Enumerações heterogêneas (evite)

// Avoid:
enum Mixed { A = 1, B = 'bee' }

Enumerações são objetos reais em tempo de execução

Iterando pelos valores de uma enumeração

enum Role { Admin = 'ADMIN', User = 'USER', Guest = 'GUEST' }
const roles = Object.values(Role);
console.log(roles); // ['ADMIN', 'USER', 'GUEST']

Verificação rápida

Recapitulação