Énumérations : constantes numériques et textuelles

Bienvenue

Énumérations numériques

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

Valeurs numériques personnalisées des énumérations

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

Énumérations de chaînes

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

Utiliser des énumérations dans les fonctions

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

Mappage inversé (numérique uniquement)

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

Énumérations const

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

Énumérations ou union de littéraux

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

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

Énumérations hétérogènes (à éviter)

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

Les énumérations sont de vrais objets à l’exécution

Parcourir les valeurs d’une énumération

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

Vérification rapide

Récapitulatif