TypeScript Enumeraciones (Enum)

Las enumeraciones (Enum) son una característica muy útil en TypeScript que nos permite definir un conjunto de constantes nombradas. Las enumeraciones hacen que el código sea más legible y fácil de mantener, ya que permiten reemplazar los "números mágicos" con nombres significativos.


Enumeraciones numéricas

Por defecto, las enumeraciones se numeran a partir de 0.

Ejemplo

enum Direction {
    Up,    // 0
    Down,  // 1
    Left,  // 2
    Right  // 3
}

var dir: Direction = Direction.Up;
console.log("Dirección: " + dir);
console.log("Nombre de la dirección: " + Direction[0]);

Resultado de ejecución:

方向: 0
方向名称: Up

Asignación manual

Se pueden asignar valores manualmente a los miembros de la enumeración.

Ejemplo

enum Status {
    Success = 1,
    Error = 2,
    Pending = 3
}

console.log("Estado: " + Status.Success);
console.log("Nombre del estado: " + Status[1]);

Resultado de ejecución:Envío

Estado: 1
状态名称: Success

Enumeraciones de cadena

En las enumeraciones de cadena, cada miembro debe tener un valor literal de cadena.

Ejemplo

enum Message {
    Success = "SUCCESS",
    Error = "ERROR",
    Warning = "WARNING"
}

console.log("Mensaje: " + Message.Success);

Resultado de ejecución:

Mensaje: SUCCESS

Enumeraciones constantes

UsandoconstLas enumeraciones modificadas con const se integran en tiempo de compilación, generando un código más optimizado.

Ejemplo

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

var favoriteColor: Color = Color.Red;
console.log("Color favorito: " + favoriteColor);

Enumeraciones heterogéneas

Las enumeraciones pueden mezclar valores numéricos y de cadena, pero no se recomienda su uso.

Ejemplo

enum BooleanLikeHeterogeneousEnum {
    No = 0,
    Yes = "YES"
}

console.log("Valor: " + BooleanLikeHeterogeneousEnum.No);
console.log("Valor de cadena: " + BooleanLikeHeterogeneousEnum.Yes);

Tipos de miembros de enumeración

Cuando todos los miembros de la enumeración son valores literales, el tipo de miembro se puede usar como tipo.

Ejemplo

enum ShapeKind {
    Circle = "circle",
    Square = "square"
}

interface Circle {
    kind: ShapeKind.Circle;
    radius: number;
}

interface Square {
    kind: ShapeKind.Square;
    sideLength: number;
}

var c: Circle = {
    kind: ShapeKind.Circle,
    radius: 10
};

console.log("Círculo: " + JSON.stringify(c));

Enumeraciones constantes en tiempo de ejecución

Las enumeraciones normales se conservan como objetos reales en tiempo de ejecución.

Ejemplo

enum FileAccess {
    Read = 1 << 1,
    Write = 1 << 2,
    ReadWrite = Read | Write
}

console.log("Acceso a archivos: " + FileAccess.ReadWrite);

Resultado de ejecución:

文件访问: 6

Resumen

  • Enumeraciones numéricas:Por defecto comienzan en 0, se pueden asignar manualmente
  • Enumeraciones de cadena:Cada miembro debe ser un literal de cadena
  • Enumeraciones constantes:Usan const, se integran en tiempo de compilación
  • Enumeraciones heterogéneas:Mezclan números y cadenas, no se recomienda
  • Tipos de miembros:Los miembros de enumeración literales se pueden usar como tipos
Otras extensiones