Перечисления: числовые и строковые константы

Добро пожаловать

Числовые перечисления

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

Пользовательские значения числовых перечислений

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

Строковые перечисления

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

Использование перечислений в функциях

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

Обратное отображение (только для числовых перечислений)

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

Константные перечисления

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

Перечисления и объединения литеральных типов

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

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

Гетерогенные перечисления (избегайте их)

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

Перечисления являются настоящими объектами во время выполнения

Перебор значений перечисления

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

Быстрая проверка

Итоги