如何实现带修改键名的TypeScript泛型类型FilterFor

API 探路者

2026-7-13

实现泛型类型 FilterFor<T>

先定义基础接口：

interface Foo {
  id: string;
  bar: string;
}

interface Person {
  name: string;
  age: number;
  birthdate: Date;
  active: boolean;
  foo: Foo;
}

泛型实现代码

// 定义不同类型对应的扩展字段规则
type FilterExtensions<T, K extends string> = 
  T extends string ? {
    [`${K}__in`]: T[];
    [`${K}__search`]: T;
  } :
  T extends number | Date ? {
    [`${K}__gt`]: T;
    [`${K}__gte`]: T;
    [`${K}__lt`]: T;
    [`${K}__lte`]: T;
  } :
  T extends object ? {
    [`${K}__in`]: Array<string | T>;
  } :
  {};

// 处理单个字段的基础类型
type FilterField<T> = 
  T extends object ? string | T :
  T;

// 核心泛型类型
type FilterFor<T> = {
  [K in keyof T as string]: FilterField<T[K]>;
} & {
  [K in keyof T as string]: FilterExtensions<T[K], K & string>;
}[keyof T];

验证效果

调用 FilterFor<Person> 后生成的类型完全符合需求：

type FilterForPerson = FilterFor<Person>;
// 等价于：
// interface FilterForPerson {
//     name: string;
//     name__in: string[];
//     name__search: string;
//     age: number;
//     age__gt: number;
//     age__gte: number;
//     age__lt: number;
//     age__lte: number;
//     birthdate: Date;
//     birthdate__gt: Date;
//     birthdate__gte: Date;
//     birthdate__lt: Date;
//     birthdate__lte: Date;
//     foo: string | Foo;
//     foo__in: Array<string | Foo>;
//     active: boolean;
// }