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 对象可能更直观。选择标准应是运行时是否需要成员集合,以及团队是否需要统一的命名空间。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

枚举类型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通