JavaScript / TypeScript / 系统课时
泛型接口与类型别名
泛型接口与类型别名
接口响应、分页列表和组件属性往往结构固定,但内部数据类型会变化。本课使用泛型接口与泛型类型别名抽离公共结构,让同一套模型安全承载用户、订单等不同业务数据。
学习目标
- 为接口和类型别名声明类型参数
- 组合多层泛型描述嵌套数据
- 根据扩展与组合需求选择合适写法
定义通用数据结构
下面用接口表示统一响应,用类型别名表示分页容器。二者可以嵌套组合,最终仍能精确得到列表元素类型。
// 外层响应与内层分页分别承载同一个实体类型
interface ApiResponse<T = unknown> {
code: number;
message: string;
data: T;
}
type Page<T> = {
items: T[];
total: number;
};
type User = {
id: number;
name: string;
};
const response: ApiResponse<Page<User>> = {
code: 0,
message: "success",
data: {
items: [
{ id: 1, name: "Ada" },
{ id: 2, name: "Lin" }
],
total: 2
}
};
console.log(response.data.total);
console.log(response.data.items.map(user => user.name).join(", "));预期输出:
2
Ada, LinApiResponse<Page<User>> 从外到内依次确定响应数据、分页结构和列表元素,访问任意层级都能获得准确提示。
接口与类型别名的选择
接口适合描述对象契约,并支持 extends 和声明合并。类型别名更适合联合类型、元组、映射类型以及复杂组合。仅描述普通对象时,两者都可以泛型化,应优先遵循项目现有风格。
提供合理默认类型
某些通用结构可以声明默认类型参数,例如 ApiResponse。默认值应安全且明确,外部数据不宜默认成 any,否则会跳过后续检查。
容器嵌套与边界
ApiResponse<Page<User>> 中,最外层 data 是 Page<User>,其 items 是 User 数组。类型参数按层替换,不会创建额外运行时包装。把某个用户的 id 改成字符串,错误应定位到内层字段,说明组合保留了完整结构。
默认参数可写为 ApiResponse<T = unknown>,省略参数时 data 仍需收窄后使用。unknown 强制读取者确认类型,any 则会跳过检查。给默认参数不代表接口响应会被运行时验证,网络返回值应先按真实协议检查。
接口可以声明合并,同名类型别名通常不能重复定义;二者都不能代替运行时构造函数。项目中若已使用 type 表达联合,不必为了泛型全部改成 interface。修改公共容器后,验证空分页、正常分页与错误字段类型,不要只检查成功响应里的两个名字。
独立验证
使用 TypeScript 5.9.3 和 Node.js 22 检查本节。分页响应应输出 2 与 Ada, Lin。把内层 User.id 改成字符串应失败,证明嵌套类型并未丢失约束;默认 unknown 数据则必须先检查才能读取属性。把主示例保存为独立目录的 main.ts,执行 npx tsc main.ts --strict --target ES2022 --module commonjs --outDir dist,预期退出码为 0;再执行 node dist/main.js 核对上述结果。说明性片段按其上下文编译,练习目录保持 CommonJS 模块约定。
