JavaScript / TypeScript / 系统课时

使用索引访问类型

使用索引访问类型

当对象类型已经定义好时,不必再次手写其中的属性结构。索引访问类型可以直接按键名提取属性类型,也能一次提取多个键,或从数组、元组中取得元素类型,从而让派生类型始终跟随源类型变化。

学习目标

  • 掌握 T[K] 的基本写法和可用键范围
  • 使用键名联合提取多个属性的联合类型
  • 使用 number 索引取得数组或元组的元素类型

从已有类型中提取属性

索引访问类型写成 T[K]:T 是被查询的类型,K 是它允许的键。这里的方括号发生在类型位置,不会读取运行时对象,也不会创建新值。

ts
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);
}

预期输出

text
Lin:7
TYPESCRIPT

UserField 的结果是 number | Profile,因为联合键会分别索引,再把结果合并为联合类型。ApiResponse["tags"][number] 则表示“任意数字下标对应的元素类型”,因此结果是 string。

组合键名与 keyof

当键名来自另一个类型时,通常先用 keyof 约束它。这样既能复用属性类型,也能阻止不存在的键进入索引访问。

ts
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] 提取元素类型,但运行时索引仍需处理越界

下一课预告

下一课将使用条件类型根据可赋值关系选择不同结果,并说明为什么条件类型遇到联合类型时会自动分发。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用索引访问类型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通