JavaScript / TypeScript / 系统课时

约束泛型参数

约束泛型参数

泛型能让一段代码适配多种类型,但并不意味着类型参数可以执行任意操作。本课通过 extends 声明泛型必须具备的能力,并使用默认类型参数减少常见场景中的重复书写。

学习目标

  • 使用 extends 为类型参数限定可用属性和方法
  • 使用 keyof 让第二个类型参数依赖第一个类型参数
  • 为泛型声明合法的默认类型

为什么泛型需要约束

未受约束的 T 可能是字符串、数字、对象或其他任意类型,因此编译器只允许执行所有类型都安全的操作。若函数需要读取 length,就应明确要求参数具有数字类型的 length 属性,而不是通过类型断言绕过检查。

约束描述的是“最低能力”,不是要求传入值必须等于某个具体类型。字符串、数组以及自定义对象只要满足约束,都可以作为实参。

使用 extends 声明所需能力

下面的函数只依赖 length,因此把这项能力提取为接口,并让 T 继承该接口。

ts
interface HasLength {
  length: number;
}

function describeLength<T extends HasLength>(value: T): string {
  // 约束保证这里可以安全读取 length
  return `length=${value.length}`;
}

console.log(describeLength("TypeScript"));
console.log(describeLength([10, 20, 30]));

// describeLength(42); // 编译错误:number 没有 length 属性

预期输出

text
length=10
length=3

extends 在泛型中表示“必须可赋值给该类型”。它与类继承使用相同关键字,但这里关注的是类型兼容性。

让类型参数彼此关联

多个类型参数可以建立依赖关系。读取对象属性时,键名必须来自对象自身,因此可用 K extends keyof T 限制键参数。

ts
function getProperty<T extends object, K extends keyof T>(
  target: T,
  key: K
): T[K] {
  return target[key];
}

const user = {
  id: 101,
  name: "Ada"
};

console.log(getProperty(user, "name"));
console.log(getProperty(user, "id"));

// getProperty(user, "email"); // 编译错误:email 不是 user 的键

预期输出

text
Ada
101

返回类型 T[K] 会随键名变化:传入 "name" 得到 string,传入 "id" 得到 number,调用方不需要手动断言。

使用默认类型简化声明

默认类型写在类型参数后方。当调用或类型引用没有提供该参数,且编译器也无法从上下文推断时,默认值才会生效。

ts
type Box<T extends HasLength = string> = {
  value: T;
  size: number;
};

const textBox: Box = {
  value: "TS",
  size: 2
};

const listBox: Box<number[]> = {
  value: [1, 2, 3],
  size: 3
};

console.log(textBox.value);
console.log(listBox.size);

预期输出

text
TS
3

默认类型也必须满足约束。这里默认值 string 具有 length,因此合法;若默认类型不满足 HasLength,声明本身就会报错。带默认值的类型参数通常放在无默认值参数之后。

常见错误

不要把约束理解成返回类型被“收窄”为约束接口。T extends HasLength 仍会保留实参的完整类型信息,只是额外保证它至少具备 length。

也不要用过宽的 object 代替真实能力。约束越贴近函数实际使用的成员,函数越容易复用,类型提示也越准确。

本课总结

  • T extends X 表示类型参数至少具备 X 描述的能力
  • K extends keyof T 可保证键名与目标对象保持一致
  • 默认类型必须满足约束,并只在未提供或无法推断时生效

下一课预告

下一课将使用 keyof 与 typeof 从现有对象中提取键和值类型,减少重复维护类型声明。

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

目录与阅读设置

阅读设置

17

记录一个想法

约束泛型参数

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

登录哪都通