HarmonyOS鸿蒙Next中ArkTS如何联合枚举类型的Key?

一、核心概念解析

枚举本质

• enum 创建双向映射：键 ⇄ 值

编译后生成真实对象：

var str = { 
  A: 0, 
  B: 1, 
  C: 2,
  0: "A", 
  1: "B", 
  2: "C"
};

关键操作符

二、实现原理详解

三、完整使用场景

类型安全约束

// 定义权限枚举
enum Permission {
  Read = 'READ',
  Write = 'WRITE',
  Execute = 'EXECUTE'
}

// 生成权限键联合类型
type PermissionKey = keyof typeof Permission; // 'Read' | 'Write' | 'Execute'

// 函数参数类型约束
function checkPermission(key: PermissionKey) {
  return Permission[key] !== undefined;
}

checkPermission('Read');  // ✅ 合法
checkPermission('Delete'); // ❌ 类型错误

动态配置系统

enum Theme {
  Light = 'light-mode',
  Dark = 'dark-mode',
  System = 'auto'
}

type ThemeKey = keyof typeof Theme;

const themeConfig: Record<ThemeKey, string> = {
  Light: '明亮主题',
  Dark: '暗黑主题',
  System: '系统跟随'
};

function applyTheme(key: ThemeKey) {
  document.body.setAttribute('data-theme', Theme[key]);
  console.log(`已启用：${themeConfig[key]}`);
}

四、进阶用法

过滤枚举键

enum LogLevel {
  Debug = 0,
  Info = 1,
  Warn = 2,
  Error = 3
}

// 提取非数字键
type LogLevelKey = Exclude<keyof typeof LogLevel, number>;
// 结果: 'Debug' | 'Info' | 'Warn' | 'Error'

反向值映射

enum Direction {
  Up = 'UP',
  Down = 'DOWN'
}

type DirectionKey = keyof typeof Direction;

function getDirectionLabel(key: DirectionKey): string {
  const map = {
    Up: '向上',
    Down: '向下'
  };
  return map[key];
}

五、与其他类型结合

六、注意事项

常量枚举限制

const enum Flags { // ❌ 错误用法
  A = 1,
  B = 2
}
type FlagKeys = keyof typeof Flags; // 报错！常量枚举无运行时对象

异构枚举处理

enum Mixed {
  A = 'a',
  B = 2
}
// 正确提取
type MixedKeys = keyof typeof Mixed; // 'A' | 'B'

TS版本兼容性

• TypeScript 2.4+ 支持字符串枚举
• TypeScript 3.4+ 优化联合类型推导

七、实际应用场景

国际化系统

enum Locale {
  EN_US = 'en-US',
  ZH_CN = 'zh-CN'
}

type LocaleKey = keyof typeof Locale;

const i18nResources: Record<LocaleKey, Record<string, string>> = {
  EN_US: { welcome: 'Welcome' },
  ZH_CN: { welcome: '欢迎' }
};

状态机实现

enum OrderStatus {
  Created = 'CREATED',
  Paid = 'PAID',
  Shipped = 'SHIPPED'
}

type StatusKey = keyof typeof OrderStatus;

const statusTransitions: Record<StatusKey, StatusKey[]> = {
  Created: ['Paid'],
  Paid: ['Shipped'],
  Shipped: []
};

API 参数验证

enum ApiEndpoint {
  Users = '/api/users',
  Products = '/api/products'
}

type EndpointKey = keyof typeof ApiEndpoint;

function callApi(endpoint: EndpointKey, params: object) {
  fetch(ApiEndpoint[endpoint], { ...params });
}

最佳实践总结：keyof typeof Enum 是 ArkTS/TypeScript 中处理枚举键联合的标准模式，通过将运行时枚举对象转换为类型空间的操作，实现严格的类型约束。这种模式在配置系统、状态管理和类型安全校验等场景具有不可替代的价值。