JavaScript / TypeScript / 系统课时
使用索引访问类型
使用索引访问类型
当对象类型已经定义好时,不必再次手写其中的属性结构。索引访问类型可以直接按键名提取属性类型,也能一次提取多个键,或从数组、元组中取得元素类型,从而让派生类型始终跟随源类型变化。
学习目标
- 掌握
T[K]的基本写法和可用键范围 - 使用键名联合提取多个属性的联合类型
- 使用
number索引取得数组或元组的元素类型
从已有类型中提取属性
索引访问类型写成 T[K]:T 是被查询的类型,K 是它允许的键。这里的方括号发生在类型位置,不会读取运行时对象,也不会创建新值。
type ApiResponse = {
user: {
id: number;
profile: {
nickname: string;
active: boolean;
};
};
tags: string[];
};
type User = ApiResponse["user"];
type Profile = ApiResponse["user"]["profile"];
type UserField = ApiResponse["user"]["id" | "profile"];
type Tag = ApiResponse["tags"][number];
function printUser(user: User, tag: Tag): void {
// User 与 Tag 都从 ApiResponse 派生,源结构变化后会同步报错
console.log(`${user.profile.nickname}:${user.id}`);
console.log(tag.toUpperCase());
}
const response: ApiResponse = {
user: {
id: 7,
profile: { nickname: "Lin", active: true }
},
tags: ["typescript", "types"]
};
const firstTag = response.tags[0];
if (firstTag !== undefined) {
printUser(response.user, firstTag);
}预期输出
Lin:7
TYPESCRIPTUserField 的结果是 number | Profile,因为联合键会分别索引,再把结果合并为联合类型。ApiResponse["tags"][number] 则表示“任意数字下标对应的元素类型”,因此结果是 string。
组合键名与 keyof
当键名来自另一个类型时,通常先用 keyof 约束它。这样既能复用属性类型,也能阻止不存在的键进入索引访问。
type ValueOf<T, K extends keyof T> = T[K];
type UserId = ValueOf<User, "id">;
type UserProfile = ValueOf<User, "profile">;这是片段示例,依赖上一个示例中的 User。K extends keyof T 保证 K 只能是 T 已有的键;若写成 ValueOf<User, "name">,编译器会直接报错。
数组与元组的索引规则
数组使用 [number] 提取统一的元素类型。元组同样可以使用 [number],但结果会是所有位置类型的联合;若使用具体位置,如 [0],则只取得该位置的类型。
| 写法 | 得到的类型 |
|---|---|
string[][number] |
string |
readonly [string, number][number] |
`string |
readonly [string, number][0] |
string |
不要把类型索引与运行时访问混为一谈。Tuple[0] 是类型运算,tuple[0] 才是读取变量中的第一个值。
常见错误与边界
索引键必须能赋给 keyof T。直接写 T[string] 并不表示“取出所有属性类型”,除非 T 本身声明了字符串索引签名。需要提取全部属性值时,可写成 T[keyof T]。
数组的 [number] 只描述元素类型,不保证运行时一定取得元素。启用 noUncheckedIndexedAccess 后,实际执行 array[index] 仍可能得到 undefined,因此示例在调用函数前做了判空。
本课总结
T[K]能从已有类型中提取属性,避免重复声明结构- 联合键会得到多个属性类型组成的联合类型
- 数组或元组使用
[number]提取元素类型,但运行时索引仍需处理越界
下一课预告
下一课将使用条件类型根据可赋值关系选择不同结果,并说明为什么条件类型遇到联合类型时会自动分发。