JavaScript / TypeScript / 系统课时

泛型接口与类型别名

泛型接口与类型别名

接口响应、分页列表和组件属性往往结构固定,但内部数据类型会变化。本课使用泛型接口与泛型类型别名抽离公共结构,让同一套模型安全承载用户、订单等不同业务数据。

学习目标

  • 为接口和类型别名声明类型参数
  • 组合多层泛型描述嵌套数据
  • 根据扩展与组合需求选择合适写法

定义通用数据结构

下面用接口表示统一响应,用类型别名表示分页容器。二者可以嵌套组合,最终仍能精确得到列表元素类型。

ts
// 外层响应与内层分页分别承载同一个实体类型
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(", "));

预期输出:

text
2
Ada, Lin

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

响应、分页与用户元素的类型嵌套

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

目录与阅读设置

阅读设置

17

记录一个想法

泛型接口与类型别名

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

登录哪都通