第30章 索引访问类型

案例30:索引访问类型——精准提取对象属性类型

题目:定义一个用户信息对象的结构,使用索引访问类型分别提取name、address.city和tags数组元素的类型,并实现一个根据属性路径更新值的函数。

设计思路

利用TypeScript的索引访问类型(T[K])可以像访问对象属性一样获取类型。对于深层属性,使用链式索引T['address']['city'];对于数组,通过T['tags'][number]提取元素类型。结合泛型约束,编写类型安全的属性更新器。

核心代码

interface User {
  name: string;
  age: number;
  address: { city: string; zip: string };
  tags: string[];
}

// 索引访问类型提取
type NameType = User['name'];           // string
type CityType = User['address']['city']; // string
type TagType = User['tags'][number];     // string

// 泛型属性更新器
function updateProperty<T, K extends keyof T>(obj: T, key: K, value: T[K]): void {
  obj[key] = value;
}

const user: User = {
  name: '张三',
  age: 30,
  address: { city: '北京', zip: '100000' },
  tags: ['前端', 'TypeScript']
};

// 类型安全的更新
updateProperty(user, 'name', '李四');
updateProperty(user, 'age', 31);
// updateProperty(user, 'age', '31'); // 错误:string不能赋给number
console.log(user.name, user.age);

运行结果验证

将上述代码保存为 index.ts,运行 ts-node index.ts,控制台输出:
李四 31

测试建议

尝试获取 User['address']['zip'] 的类型,验证为 string。修改tags为数字数组,观察 TagType 自动变为 number。

注意事项

索引访问类型只能用于类型位置,不能用于值位置。对联合类型使用索引访问时,结果会自动分配(如 User['name'|'age'] 得到 string | number)。

常见错误

访问不存在的属性如 User['phone'] 会编译报错。使用 keyof 约束泛型时,T[K] 确保返回值的类型安全。

成功要点

索引访问类型是构建类型工具的基础,常用于Partial、Readonly等映射类型的实现。掌握它可大幅提升类型推导的精准度。