JavaScript / TypeScript / 系统课时

多类型参数

多类型参数

一个类型参数只能表达一种可变类型,当输入、输出或成对数据各自拥有不同类型时,需要使用多个类型参数。本课将通过转换函数和键值对说明如何分别命名类型,并保持它们之间的关联。

学习目标

  • 在函数中声明多个类型参数
  • 描述输入类型与输出类型的转换关系
  • 为不同角色选择清晰的类型参数名称

描述输入与输出

TInput 表示输入类型,TOutput 表示转换结果。回调函数把两者连接起来,编译器会同时检查参数和返回值。

ts
// 输入、输出承担不同角色,分别声明类型参数
function transform<TInput, TOutput>(
  input: TInput,
  mapper: (value: TInput) => TOutput
): TOutput {
  return mapper(input);
}

function createEntry<TKey, TValue>(
  key: TKey,
  value: TValue
): { key: TKey; value: TValue } {
  return { key, value };
}

const nameLength = transform("TypeScript", value => value.length);
const entry = createEntry("enabled", true);

console.log(nameLength);
console.log(`${entry.key}=${entry.value}`);

预期输出:

text
10
enabled=true

nameLength 被推断为 number,而 entry 同时保留键的字符串类型和值的布尔类型。

类型参数应表达角色

简单函数可以使用 T、U,但参数较多时应使用 TInput、TOutput、TKey、TValue 等名称。清晰命名能避免把不同类型误当成同一种类型。

不要无意义地增加参数

只有当类型参数至少参与一个参数、返回值或其他类型关系时才有价值。若某个类型参数只出现一次,通常无法建立约束或关联,应考虑直接使用具体类型。

保留输入输出关系

transform 的第二个参数接收 TInput 并返回 TOutput,编译器从实参和回调推断两端类型。mapper 写成 value.length 时,字符串输入合法;若把输入改为数字,回调中的 length 访问应失败。这能检验回调没有被无意放宽成 any。

createEntry 的键和值使用两个参数,因为它们无需相同。若都写成同一个 T,字符串键与布尔值会受到不必要的关联约束。相反,如果两个位置确实必须是同一类型,应复用一个参数,不能为了名字好看把关联拆掉。

类型推断也可能扩大字面量,例如普通可变字符串属性往往表现为 string,不一定保留具体的 enabled。需要精确字面量时应明确只读或字面量约束,并检查推断结果。验证不仅要运行输出,还要尝试错误回调和错误赋值,确认编译器阻止了原本希望禁止的调用。

独立验证

使用 TypeScript 5.9.3 和 Node.js 22 检查本节。转换结果应为数字 10,键值对打印 enabled=true。把 transform 的输入改为 42,却在回调访问 length,应产生属性错误;检查完成后撤销该负例。把主示例保存为独立目录的 main.ts,执行 npx tsc main.ts --strict --target ES2022 --module commonjs --outDir dist,预期退出码为 0;再执行 node dist/main.js 核对上述结果。说明性片段按其上下文编译,练习目录保持 CommonJS 模块约定。

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

目录与阅读设置

阅读设置

17

记录一个想法

多类型参数

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

登录哪都通