JavaScript / TypeScript / 系统课时
索引访问类型
索引访问类型
索引访问类型使用 T[K] 从已有类型中取出某个属性或一组属性对应的值类型。它能直接复用现有模型,避免重复声明字段类型,也能从数组、元组和键联合中提取精确类型。
学习目标
- 使用
T["key"]提取对象属性类型 - 理解联合键索引产生的联合值类型
- 使用
T[number]提取数组或元组元素类型
提取对象属性类型
只要键存在于目标类型中,就可以写成 T["属性名"]。例如 User["id"] 得到 number,User["name"] 得到 string。这种写法引用的是原模型,因此原字段类型变化后,派生类型也会同步变化。
如果写成 User["missing"],TypeScript 会直接报错,因为 missing 不是 User 的合法属性键。索引访问类型不会容忍不存在的属性名。
联合键会得到联合值
索引位置也可以是联合类型。若使用 User["id" | "name"],结果就是 number | string。进一步写成 User[keyof User],可以得到对象全部属性值类型的联合。
这使得“键集合”和“值集合”可以从同一个模型派生,而不需要手工复制类型。下面的主示例把对象属性、数组元素、元组字面量和泛型赋值放在一起验证:
type User = {
id: number;
name: string;
active: boolean;
};
const id: User["id"] = 42;
const displayValue: User["id" | "name"] = "Grace";
// T[number] 从数组类型中提取单个元素的完整对象类型。
const rows = [
{ id: 1, title: "Intro" },
{ id: 2, title: "Types" },
];
type Row = (typeof rows)[number];
const current: Row = { id: 3, title: "Generics" };
// as const 保留字面量,使元素类型成为三个字符串字面量的联合。
const levels = ["info", "warn", "error"] as const;
type Level = (typeof levels)[number];
const level: Level = "warn";
// 键决定 value 的类型,错误组合会在编译阶段被拒绝。
function setProperty<T, K extends keyof T>(obj: T, key: K, value: T[K]): void {
obj[key] = value;
}
const settings = { retries: 3, mode: "safe" };
setProperty(settings, "retries", 5);
console.log(id, displayValue);
console.log(current.id, current.title);
console.log(level);
console.log(settings);预期输出:
42 Grace
3 Generics
warn
{ retries: 5, mode: 'safe' }如果把 displayValue 改成 true,会因为 boolean 不属于 number | string 而编译失败;如果调用 setProperty(settings, "retries", "many"),也会因为值与 number 不匹配而失败。
从数组与元组提取元素
数组通过数字下标访问,因此 T[number] 是提取元素类型的常见写法。对于普通数组,(typeof rows)[number] 得到每个元素共享的对象类型;这比重新写一份 Row 接口更不容易与真实数据结构脱节。
元组配合 as const 时更有价值。示例中的 Level 被推断为 "info" | "warn" | "error",所以只能使用这三个字面量。若删除 as const,数组元素通常会被拓宽为 string,精确的字面量联合也会随之丢失。
与 keyof 组合建立类型关系
keyof 负责得到合法键,索引访问类型负责根据键得到对应值。K extends keyof T 与 T[K] 组合后,就能表达“传入哪个键,就必须使用那个键对应的值类型”。
这种关系常用于表单字段更新、配置对象读写、通用数据表格和对象工具函数。关键不是把类型写得更复杂,而是让派生类型始终引用唯一的数据模型,从而减少字段改名或类型调整后产生的不一致。