Day13: 【TypeScript 学起来】只有 TS 才有的型别: Enum (列举)

是说TS针对型别的类型也太讲究，写好多天还没写完(其实是我30篇不够XDD)，哈哈不罗嗦， 今天继续笔记列举（Enums）型别。

列举（Enums）型别用於取值被限定在一定范围内的场景，可以用来管理多个同系列的常数，作为状态判断使用。比如一周只能有七天，颜色限定为红绿蓝等。也可以自定义来表示每一个值。

Numeric Enums

使用enum关键字来定义:

enum Days {Sun, Mon, Tue, Wed, Thu, Fri, Sat};

这时候我们来看编译後，列举成员会被赋值为从 0 开始自动递增的数字，同时也会对列举值到列举名进行反向对映：

var Days;
(function (Days) {
    Days[Days["Sun"] = 0] = "Sun";
    Days[Days["Mon"] = 1] = "Mon";
    Days[Days["Tue"] = 2] = "Tue";
    Days[Days["Wed"] = 3] = "Wed";
    Days[Days["Thu"] = 4] = "Thu";
    Days[Days["Fri"] = 5] = "Fri";
    Days[Days["Sat"] = 6] = "Sat";
})(Days || (Days = {}));

手动赋值

可以手动去定义不同的值。

enum Days {Sun = 7, Mon = 1, Tue, Wed, Thu, Fri, Sat};

编译後：

var Days;
(function (Days) {
    Days[Days["Sun"] = 7] = "Sun";
    Days[Days["Mon"] = 1] = "Mon";
    Days[Days["Tue"] = 2] = "Tue";
    Days[Days["Wed"] = 3] = "Wed";
    Days[Days["Thu"] = 4] = "Thu";
    Days[Days["Fri"] = 5] = "Fri";
    Days[Days["Sat"] = 6] = "Sat";
})(Days || (Days = {}));

要小心覆盖的情况

如果中间突然指定了了一个值，那他会从当前的值从新开始计算。如下， Days[3] 的值先是 "Sun"，而後又被 "Wed" 覆盖了。这个TypeScript 是不会报错的，所以要特别注意。

enum Days {Sun = 3, Mon = 1, Tue, Wed, Thu, Fri, Sat};

console.log(Days["Sun"] === 3); // true
console.log(Days["Wed"] === 3); // true
console.log(Days[3] === "Sun"); // false
console.log(Days[3] === "Wed"); // true

可使用型别断言（Type Assertion）来定义

手动赋值的列举项其中一个不想是数字，此时可以使用 any 型别断言来让TypeScript 无视型别检查。

enum Days {Sun = 7, Mon, Tue, Wed, Thu, Fri, Sat = <any>"S"};

编译後：

var Days;
(function (Days) {
    Days[Days["Sun"] = 7] = "Sun";
    Days[Days["Mon"] = 8] = "Mon";
    Days[Days["Tue"] = 9] = "Tue";
    Days[Days["Wed"] = 10] = "Wed";
    Days[Days["Thu"] = 11] = "Thu";
    Days[Days["Fri"] = 12] = "Fri";
    Days[Days["Sat"] = "S"] = "Sat";
})(Days || (Days = {}));

String Enums 字串列举

字串 enums 没有number enums 可以自动递增的行为， 但字串enum自行定义是有他的语意在的。

enum Direction {
  Up = "UP",
  Down = "DOWN",
  Left = "LEFT",
  Right = "RIGHT",
}

Heterogeneous Enums 异构列举

虽然enum可以混合数字与字串，但尽量不要写这种写法：

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

Computed and constant members 常数项和计算所得项

列举项有两种型别：常数项（constant member）和计算所得项（computed member）。

前面我们所举的例子都是常数项，一个典型的计算所得项的例子如下，"blue".length 就是一个计算所得项。：

enum Color {Red, Green, Blue = "blue".length};
console.log(Color.Blue); //4

如何定义是常数项，可参考 这篇 或官网。

像是二元运算子 << 、 |、& 等都归为常数项：

enum FileAccess {
  // constant members
  None,
  Read = 1 << 1,
  Write = 1 << 2,
  ReadWrite = Read | Write,
  // computed member
  G = "123".length,
}

Const Enums 常数列举

可以使用 const enum 定义的列举型别：

const enum Directions {
    Up,
    Down,
    Left,
    Right
}

let directions = [Directions.Up, Directions.Down, Directions.Left, Directions.Right];

常数列举与普通列举的区别是，它会在编译阶段被删除，并且不能包含computed member(计算成员)， 只能是常数项（constant member）。

编译後：

var directions = [0 /* Up */, 1 /* Down */, 2 /* Left */, 3 /* Right */];

Ambient Enums 外部列举

外部列举（Ambient Enums）是使用 declare enum 定义的列举型别：

declare enum Directions {
    Up,
    Down,
    Left,
    Right
}

let directions = [Directions.Up, Directions.Down, Directions.Left, Directions.Right];

declare 定义的型别只会用於编译时的检查，编译结果中会被删除。

编译後：

var directions = [Directions.Up, Directions.Down, Directions.Left, Directions.Right];

下一篇终於来介绍interface了!! 撒花～

参考资料

https://willh.gitbook.io/typescript-tutorial/advanced/enum#chang-shu-xiang-he-ji-suan-suo-de-xiang
https://www.typescriptlang.org/docs/handbook/enums.html