JavaScript / TypeScript / 系统课时
枚举类型
枚举类型
本课介绍 TypeScript 枚举的声明、取值和运行时表现。你将掌握数字枚举与字符串枚举的差异,并判断什么时候枚举比普通字符串联合类型更合适。
学习目标
- 声明并使用数字枚举和字符串枚举
- 理解枚举会生成运行时 JavaScript 对象
- 判断枚举的合理使用场景
数字枚举
数字枚举默认从 0 开始递增:
ts
enum LessonStatus {
Draft,
Published,
Archived
}
const currentStatus: LessonStatus = LessonStatus.Published;
console.log(currentStatus);
console.log(LessonStatus[currentStatus]);预期输出
text
1
Published数字枚举不仅可以从名称获取数值,还可以从数值反向获取名称。它适合需要与数字协议或历史数据对应的场景,但直接看到 1 时不如字符串直观。
字符串枚举
字符串枚举需要为每个成员明确赋值:
ts
enum PayState {
Pending = "PENDING",
Success = "SUCCESS",
Failed = "FAILED"
}
function showState(state: PayState): string {
return `当前状态:${state}`;
}
console.log(showState(PayState.Success));预期输出
text
当前状态:SUCCESS字符串枚举没有数字枚举的自动递增和反向映射,但日志、接口和数据库中的值更容易理解。
运行时表现
枚举与接口、类型别名不同。普通枚举会编译为 JavaScript 对象,因此运行时可以读取成员,也会增加一定输出代码。
ts
enum Direction {
Left = "LEFT",
Right = "RIGHT"
}
console.log(Object.values(Direction));预期输出
text
[ 'LEFT', 'RIGHT' ]不同运行环境对数组输出格式的空格可能略有差异,但成员值应一致。
与字符串联合类型比较
只需要限制几个固定文本值时,字符串联合类型通常更轻量:
ts
type Theme = "light" | "dark";
function applyTheme(theme: Theme): string {
return `使用 ${theme} 主题`;
}
console.log(applyTheme("dark"));预期输出
text
使用 dark 主题联合类型在编译后完全消失,不提供运行时对象。若代码需要遍历所有值、与既有枚举协议对接,普通枚举更方便;若只做静态约束,联合类型通常更简洁。
使用边界
不要把每组常量都改成枚举。配置项很少、无需运行时访问时,联合类型或 as const 对象可能更直观。选择标准应是运行时是否需要成员集合,以及团队是否需要统一的命名空间。
按自己的节奏,确认真正理解。