JavaScript / TypeScript / 系统课时
约束泛型参数
约束泛型参数
泛型能让一段代码适配多种类型,但并不意味着类型参数可以执行任意操作。本课通过 extends 声明泛型必须具备的能力,并使用默认类型参数减少常见场景中的重复书写。
学习目标
- 使用
extends为类型参数限定可用属性和方法 - 使用
keyof让第二个类型参数依赖第一个类型参数 - 为泛型声明合法的默认类型
为什么泛型需要约束
未受约束的 T 可能是字符串、数字、对象或其他任意类型,因此编译器只允许执行所有类型都安全的操作。若函数需要读取 length,就应明确要求参数具有数字类型的 length 属性,而不是通过类型断言绕过检查。
约束描述的是“最低能力”,不是要求传入值必须等于某个具体类型。字符串、数组以及自定义对象只要满足约束,都可以作为实参。
使用 extends 声明所需能力
下面的函数只依赖 length,因此把这项能力提取为接口,并让 T 继承该接口。
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 属性预期输出
length=10
length=3extends 在泛型中表示“必须可赋值给该类型”。它与类继承使用相同关键字,但这里关注的是类型兼容性。
让类型参数彼此关联
多个类型参数可以建立依赖关系。读取对象属性时,键名必须来自对象自身,因此可用 K extends keyof T 限制键参数。
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 的键预期输出
Ada
101返回类型 T[K] 会随键名变化:传入 "name" 得到 string,传入 "id" 得到 number,调用方不需要手动断言。
使用默认类型简化声明
默认类型写在类型参数后方。当调用或类型引用没有提供该参数,且编译器也无法从上下文推断时,默认值才会生效。
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);预期输出
TS
3默认类型也必须满足约束。这里默认值 string 具有 length,因此合法;若默认类型不满足 HasLength,声明本身就会报错。带默认值的类型参数通常放在无默认值参数之后。
常见错误
不要把约束理解成返回类型被“收窄”为约束接口。T extends HasLength 仍会保留实参的完整类型信息,只是额外保证它至少具备 length。
也不要用过宽的 object 代替真实能力。约束越贴近函数实际使用的成员,函数越容易复用,类型提示也越准确。
本课总结
T extends X表示类型参数至少具备X描述的能力K extends keyof T可保证键名与目标对象保持一致- 默认类型必须满足约束,并只在未提供或无法推断时生效
下一课预告
下一课将使用 keyof 与 typeof 从现有对象中提取键和值类型,减少重复维护类型声明。