JavaScript / TypeScript / 系统课时
泛型约束
泛型约束
完全不受限制的类型参数不能访问任何特定成员,但很多通用函数又确实要求输入具备某种结构。本课使用 extends 添加泛型约束,让函数只接受满足条件的类型,同时保留传入值的具体类型。
学习目标
- 使用
extends约束类型参数 - 在泛型函数中安全访问必需成员
- 理解约束不会把返回值降级为约束类型
添加结构约束
下面的函数要求输入必须拥有数值类型的 length 属性,因此字符串、数组等值可以使用,数字则会被编译器拒绝。
// 只要求 length,返回时仍保留具体输入类型
type HasLength = {
length: number;
};
function logLength<T extends HasLength>(value: T): T {
console.log(`length=${value.length}`);
return value;
}
const text = logLength("TypeScript");
const numbers = logLength([10, 20, 30]);
console.log(text.toUpperCase());
console.log(numbers.reduce((sum, item) => sum + item, 0));预期输出:
length=10
length=3
TYPESCRIPT
60返回类型仍然是传入的具体 T,所以字符串可以继续调用 toUpperCase,数组也保留元素类型和数组方法。
约束采用结构类型
T extends HasLength 不要求显式继承接口,只要值的结构中包含兼容的 length: number 即可。约束描述的是最低要求,不会删除额外属性。
常见误区
T extends object 只能排除原始值,不能保证对象拥有某个业务字段。需要访问 id、name 等成员时,应把这些字段明确写进约束,而不是依赖类型断言。
约束保证的最小能力
约束只保证 length 是 number,不保证它是非负整数,更不保证它与某个真实集合长度一致。传入 {length: -1} 在类型层面合法,若业务需要长度范围,应在运行时另外验证。不要从一个属性约束推断对象一定可迭代。
把 logLength(42) 加入示例,编译器应报告数字不满足 HasLength;传入 {length: 2, label: "ok"} 则能保留 label 字段。对照这两个调用可以确认约束检查与返回具体类型同时生效,而不是把返回值统一写成 HasLength。
函数返回原输入,因此调用方与函数共享同一对象;约束没有防御性复制的含义。若实现要返回新对象,不能随意把只有 length 的对象断言成 T,因为 T 可能还要求其他字段。根据返回值真实结构重新设计类型,比用 as T 压制错误更可靠。
独立验证
使用 TypeScript 5.9.3 和 Node.js 22 检查本节。长度应分别为 10 与 3,返回值仍能调用字符串和数组方法。额外调用 logLength(42) 应失败;传入含 length 与额外字段的对象则应保留那些字段的类型。把主示例保存为独立目录的 main.ts,执行 npx tsc main.ts --strict --target ES2022 --module commonjs --outDir dist,预期退出码为 0;再执行 node dist/main.js 核对上述结果。说明性片段按其上下文编译,练习目录保持 CommonJS 模块约定。