JavaScript / TypeScript / 系统课时
泛型函数
泛型函数
当函数逻辑与具体类型无关时,使用 any 虽然能接收任意值,却会丢失输入与输出的类型关系。本课通过类型参数编写泛型函数,让同一份实现复用在多种类型上,同时保留精确的返回类型。
学习目标
- 使用类型参数声明泛型函数
- 依靠类型推断获得具体返回类型
- 区分泛型与
any的类型效果
声明类型参数
类型参数通常写在函数名后的尖括号中。T 只是占位名称,表示一次调用中由调用者或编译器确定的具体类型。
// 空数组可能没有首项,返回值保留 undefined
function first<T>(items: readonly T[]): T | undefined {
return items[0];
}
function wrap<T>(value: T): { value: T } {
return { value };
}
const firstNumber = first([10, 20, 30]);
const firstName = first(["Ada", "Lin"]);
const wrappedUser = wrap({ id: 1, name: "Ada" });
console.log(firstNumber);
console.log(firstName?.toUpperCase());
console.log(wrappedUser.value.name);预期输出:
10
ADA
Ada编译器从实参推断出 firstNumber 为 number | undefined、firstName 为 string | undefined,而 wrappedUser.value 保留完整对象结构。
显式指定类型参数
多数情况下应优先让编译器推断。只有实参信息不足,或需要主动限制目标类型时,才显式写出类型参数,例如 wrap<string>("hello")。
泛型不是任意操作
T 可能代表任何类型,因此函数体不能直接访问未被约束的成员。例如在没有额外条件时,不能假设 T 一定拥有 length。这类需求将在下一课通过泛型约束解决。
空数组与类型推断
first 在空数组时返回 undefined,因此返回类型不能只写 T。读取结果前必须判断是否存在,或使用可选链;直接加非空断言会让空输入在运行时出错。可临时输出 first<number>([]),预期为 undefined,用来检查这个边界。
类型参数在每次调用时独立确定,数字数组与字符串数组不会互相污染。显式 wrap<string>("hello") 表达调用方要求字符串;把数值传给这个调用应编译失败。通常已有实参足以推断类型,无需把每次调用都写成长形式。
泛型不会在运行时自动判断输入的类型,也不会复制传入对象。wrap 返回的新外壳仍持有原对象引用,后续修改对象字段可被双方观察到。若 API 要隔离修改,需要另行设计复制或不可变约定。readonly 数组参数限制函数里的写操作,不能保证所有外部持有者都不修改同一数组。
独立验证
使用 TypeScript 5.9.3 和 Node.js 22 检查本节。首项示例应保持 10、ADA、Ada 三行输出;再调用 first<number>([]),结果应是 undefined。显式 wrap<string>(42) 则应在编译阶段失败,不能为了运行而加断言。把主示例保存为独立目录的 main.ts,执行 npx tsc main.ts --strict --target ES2022 --module commonjs --outDir dist,预期退出码为 0;再执行 node dist/main.js 核对上述结果。说明性片段按其上下文编译,练习目录保持 CommonJS 模块约定。