使用枚举可以定义一些带名字的常量,TS支持数字的和基于字符串的枚举
使用:通过枚举的属性来访问枚举成员,通过枚举的名字来访问枚举类型
类型:
- 数字枚举:成员的值都为常量
- 字符串枚举:每个成员都必须用字符串字面量,或另外一个字符串枚举成员进行初始化
- 异构枚举:枚举可以混合字符串和数字成员(一般不建议这么做)
注:
- 如果不手动设置值的话,每个成员的值都是自增长的
- 枚举每个成员的值都是不同的
- 由于字符串枚举没有自增长的行为,可以很好的序列化:字符串枚举提供一个运行时有意义的并且可读的值,独立于枚举成员的名字
// 数字枚举
// Up使用初始化为1,其余成员从1开始自动增长即:Direction.Up的值为1,Down为2...
enum Direction {
Up = 1,
Down,
Left,
Right
}
// a默认0,b为1
enum Direction {
a,
b,
c
}
// 使用枚举
enum Responses {
No = 0,
Yes = 1
}
function respond(recipient: string, message: Responses): void {
console.log(`Princess Caroline ${recipient},${message}`)
}
respond("Bob", Responses.Yes);
// 字符串枚举
// 每个成员都必须用字符串字面量,或另外一个字符串枚举成员进行初始化
enum Positions {
Up = "UP",
Down = "DOWN",
Left = "LEFT",
Right = "RIGHT"
}
// 异构枚举
enum BoolEnum {
No = 0,
Yes = 'YES'
}
计算的和常量成员
每个枚举都有一个枚举值,可以是常量或者计算出来的,当满足下面条件时,枚举成员被当做是常量:
- 是枚举的第一个成员,且没有初始化器
- 不带有初始化器,并且他之前的枚举成员是一个数字常量,此时当前枚举值为加1
- 枚举成员使用常量枚举表达式初始化,常量枚举表达式是TS表达式的子集,可以在编译阶段求值。
当表达式满足下列条件之一时就是常量枚举表达式:
- 一个枚举表达式字面量(主要是:字符串字面量或数字字面量)
- 一个对之前定义的常量枚举成员的引用(可以是在不同的枚举类型中定义的)
- 带括号的常量枚举表达式
- 一元运算符+,-,~其中之一应用在了常量枚举表达式
- 常量枚举表达式作为二元运算符+,-,*,/,%,<<, >>, >>>, &, |,^的操作对象
// 枚举的第一个长远
enum E { X }
// 之前的枚举成员是一个数字常量
enum E1 { X, Y, Z };
enum E2 { A = 1, B, C }
// 所有其它情况的枚举成员被当作是需要计算得出的值
enum FileAccess {
None,
Read = 1 << 1,
Write = 1 << 2,
ReadWrite = Read | Write,
G = '123'.length
}
联合枚举与枚举成员的类型
存在一种非计算的常量枚举成员的子集:字面量枚举成员,指不带有初始值的常量枚举成员,或者值被初始化为:
- 任何字符串字面量
- 任何数字字面量
- 应用了一元-符号的数字字面量(例如:-1,-100)
当所有枚举成员都拥有字面量枚举值时,他就带有了一种特殊的语义
// 枚举成员成为了类型。例如:可以说某些成员只能是枚举成员的值
enum ShapeKind {
Circle,
Square
}
interface Circle {
kind: ShapeKind.Circle;
radius: number;
}
interface Square {
kind: ShapeKind.Square;
sideLength: number;
}
let c: Circle = {
kind: ShapeKind.Circle,
radius: 100
}
enum D {
Foo,
Bar,
}
function f(x: D){
// 报错,原因是如果不为Foo那么只能为Bar
// if(x !== D.Foo || x !== D.Bar){}
}
// 运行时的枚举:枚举是在运行时真正存在的对象
enum Enu {
X, Y, Z
}
function fn(obj: { X: number }){
return obj.X;
}
console.log(fn(Enu))
反向映射
除了创建一个属性名作为对象成员的对象之外,数字枚举成员还具有反向映射,从枚举值到枚举名字
注:不会为字符串枚举成员生成反向映射
enum Ennn { A, B }
let a = Ennn.A;
let nameA = Ennn[a];
const枚举
常量枚举只能使用常量枚举表达式,并且他们在编译阶段会被删除。常量枚举在使用的时候会被内联进来,这么做的原因是常量枚举不允许包含计算成员
const enum Emmm {
A = 1,
B = A * 2
}
const enum PositionC {
Up,
Dwon,
Left,
Right
}
let ppstions = [PositionC.Up,PositionC.Dwon,PositionC.Left,PositionC.Right];
外部枚举
用来描述已经存在的枚举类型的形状
外部枚举和非外部枚举之间有一个重要的区别,在正常的枚举里,没有初始化方法的成员被当成常数成员。
对于非常数的外部枚举而言,没有初始化方法时被当做需要经过计算的
declare enum Ennm {
A = 1,
B,
C = 2
}
let results = [Ennm.A]
网友评论