枚举反向映射的意外行为
快速摘要
你迭代数字枚举时同时得到了键和值 —— TypeScript 为数字枚举创建反向映射。
为什么发生
你对数字枚举使用 Object.keys() 或 for...in,包含反向映射的值到键条目
你期望只有枚举键但由于反向映射同时得到了键和数字值
字符串枚举改为数字枚举,引入反向映射破坏了现有迭代代码
最小示例
✗ 错误代码
enum Status { Active, Inactive, Pending }
console.log(Object.keys(Status)); // ['0', '1', '2', 'Active', 'Inactive', 'Pending']
console.log(Object.values(Status)); // [0, 1, 2, 'Active', 'Inactive', 'Pending']✓ 修复代码
const Status = { Active: 'Active', Inactive: 'Inactive', Pending: 'Pending' } as const;
console.log(Object.keys(Status)); // ['Active', 'Inactive', 'Pending']
console.log(Object.values(Status)); // ['Active', 'Inactive', 'Pending']使用 const 对象替代数字枚举消除了反向映射,迭代只产生已定义的键和值。
如何诊断
记录 Object.keys(Enum) 和 Object.values(Enum) 查看额外的反向映射条目
检查枚举是数字(有反向映射)还是字符串(无反向映射)
迭代数字枚举时使用类型守卫或过滤器分离键和值
如何修复
使用字符串枚举而非数字枚举完全避免反向映射
迭代时过滤掉数字键:keys.filter(k => isNaN(Number(k)))
使用 'as const' 的常量对象替代枚举以更好地控制迭代
如何预防
优先使用字符串枚举或常量对象而非数字枚举以避免反向映射意外
永远不要直接迭代枚举 —— 使用已知键或值的类型化数组
相关资源
相关术语
相关课程
- 枚举
学习枚举。