第29章 keyof操作符

案例29:keyof操作符——动态获取对象键的联合类型

题目:定义一个设备配置对象,使用keyof提取其所有键的联合类型,并实现一个类型安全的字段读取函数。

设计思路

通过keyof操作符可以直接从对象类型中推导出所有键的联合类型(如'type' | 'brand' | 'price')。结合泛型约束K extends keyof T,可以确保访问对象属性时键名绝对安全,避免运行时错误。

核心代码

interface Device {
  type: string;
  brand: string;
  price: number;
}

const laptop: Device = {
  type: 'notebook',
  brand: 'Lenovo',
  price: 5999
};

// keyof 用法:类型安全地读取属性
function getProp<T, K extends keyof T>(obj: T, key: K): T[K] {
  return obj[key];
}

// 验证
const brand = getProp(laptop, 'brand');  // 类型为 string
const price = getProp(laptop, 'price');  // 类型为 number
console.log(brand, price);

运行结果验证

控制台输出:Lenovo 5999。若传入不存在的键'color',TypeScript编译器会立即报错,提示参数类型不匹配。

测试建议

分别尝试getProp(laptop, 'type')、getProp(laptop, 'price'),并故意写错键名验证编译报错效果。也可用Object.keys对比运行时行为。

成功要点

keyof Device可单独使用:let key: keyof Device = 'brand';,该变量只能赋值为三个已知键之一。

常见误区

keyof只针对类型而非值。若直接写keyof laptop会报错,需先定义typeof laptop:keyof typeof laptop。

推荐写法

用keyof配合索引访问类型T[K],可实现完全类型安全的查找函数,大幅减少运行时错误。

环境依赖:TypeScript 4.0+,仅标准库,运行命令tsc 29.ts && node 29.js。