You need to enable JavaScript to run this app. TypeScript如何定义必须包含联合类型所有值且无重复的数组
优惠活动
大模型
产品
解决方案
定价
更多

TypeScript如何定义必须包含联合类型所有值且无重复的数组

TypeScript 实现联合类型全量无重复数组的校验方案

核心实现代码

首先定义通用工具类型:

// 基础工具:判断两个类型是否完全相等
type Equal<X, Y> =
  (<T>() => T extends X ? 1 : 2) extends
  (<T>() => T extends Y ? 1 : 2) ? true : false;

// 工具:移除元组中的重复类型
type RemoveDuplicates<T extends any[], Seen extends any[] = []> =
  T extends [infer First, ...infer Rest]
    ? First extends Seen[number]
      ? RemoveDuplicates<Rest, Seen>
      : RemoveDuplicates<Rest, [...Seen, First]>
    : Seen;

// 核心校验类型:要求输入的元组恰好包含联合类型U的所有成员,无重复无遗漏
type TupleOfAllUnion<U, T extends U[]> =
  Equal<RemoveDuplicates<T>[number], U> extends true
    ? T
    : never;

使用方式

推荐封装工厂函数简化调用,无需手动声明元组类型:

// 针对Pet类型封装的校验生成函数
function createPetList<T extends Pet[]>(list: TupleOfAllUnion<Pet, T>) {
  return list;
}

效果验证

// 合法写法:无遗漏无重复,不会报错
const pets = createPetList(['dog', 'cat', 'rat']);

// 非法写法:缺少cat、rat,重复dog,TS会直接抛出类型错误
const wrongPets = createPetList(['dog', 'dog']);

如果不想额外定义函数,也可以直接用类型注解:

const pets: TupleOfAllUnion<Pet, ['dog', 'cat', 'rat']> = ['dog', 'cat', 'rat'];

该方案不限制数组的元素顺序,你可以根据业务需要调整下拉选项的排序,只要满足全量无重复的要求就能通过校验。后续第三方库更新Pet新增可选值时,原有合法声明会自动报错,提示你补全选项。

内容的提问来源于stack exchange,提问作者Noitidart

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.15 16:24:10