JavaScript / TypeScript / 系统课时

泛型约束

泛型约束

完全不受限制的类型参数不能访问任何特定成员,但很多通用函数又确实要求输入具备某种结构。本课使用 extends 添加泛型约束,让函数只接受满足条件的类型,同时保留传入值的具体类型。

学习目标

  • 使用 extends 约束类型参数
  • 在泛型函数中安全访问必需成员
  • 理解约束不会把返回值降级为约束类型

添加结构约束

下面的函数要求输入必须拥有数值类型的 length 属性,因此字符串、数组等值可以使用,数字则会被编译器拒绝。

ts
// 只要求 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));

预期输出:

text
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 模块约定。

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

目录与阅读设置

阅读设置

17

记录一个想法

泛型约束

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

登录哪都通