第19章 泛型约束
案例19:泛型约束——限制泛型必须具有length属性
题目:编写一个泛型函数
printLength,要求传入的参数必须具有 length 属性(如数组、字符串、类数组对象),并在控制台输出其长度。若传入数字或布尔值,则编译报错。
设计思路
利用 extends 关键字对泛型 T 进行约束,使其必须符合 { length: number } 结构。这样在函数体内访问 arg.length 时,TypeScript 能确认该属性存在,避免运行时错误。
核心代码
interface HasLength {
length: number;
}
function printLength<T extends HasLength>(arg: T): void {
console.log(`长度: ${arg.length}`);
}
// 正确调用
printLength("TypeScript"); // 字符串有 length
printLength([1, 2, 3]); // 数组有 length
printLength({ length: 10 }); // 自定义对象
// 错误调用(编译报错)
// printLength(123); // 数字无 length 属性
运行结果
长度: 10
长度: 3
长度: 10
测试建议:在 VS Code 中取消注释
printLength(123),观察编辑器立即显示红色波浪线,编译报错“类型‘number’不满足约束‘HasLength’”。
注意:约束必须使用
extends 而非 implements。泛型约束是结构类型检查,只要对象有 length 属性即可通过。
成功要点:泛型约束让函数同时支持字符串、数组和自定义对象,兼顾类型安全与复用性。这是编写通用工具函数(如获取长度、排序)的基础模式。