You need to enable JavaScript to run this app. TypeScript 自定义Factory处理联合Props时属性解构报错的解决
优惠活动
大模型
产品
解决方案
定价
更多

TypeScript 自定义Factory处理联合Props时属性解构报错的解决

为什么会出现这个报错

泛型Factory<T>里的Partial<T>,当T是联合类型AvatarProps时,实际类型是Partial<AvatarOnlyProps> | Partial<ClickableAvatarProps>,本身是个联合结构。
TS 解构联合类型对象时,只允许取两个分支共有的属性。label和onClick是可点击头像分支的专属属性,在纯展示头像的分支里根本不存在,所以直接解构这两个属性就会触发“属性不存在”的类型报错。
另外原来的写法本身也有逻辑问题:如果入参是纯展示头像的参数,直接组装返回值会把label、onClick的undefined值混进去,破坏两个Props分支的互斥约束。

修正后的实现

不要直接对联合类型的入参做解构,先提取所有分支共有的属性做默认值兜底,再通过属性存在判断做类型收窄,分分支组装返回值:

const createProps: Factory<AvatarProps> = (state = {}) => {
  // 提取公共属性,做默认值兜底
  const commonProps = {
    alt: state.alt ?? 'Your avatar',
    src: state.src ?? '/images/default-avatar.png'
  };

  // 检测到可点击分支的专属属性时,TS自动收窄为对应分支类型
  if ('label' in state || 'onClick' in state) {
    return {
      ...commonProps,
      label: state.label!,
      onClick: state.onClick
    };
  }

  // 无专属属性则返回纯展示头像的Props
  return commonProps;
};

这段代码不会再触发解构报错,TS 会通过in操作符自动完成类型推导,返回值也会严格符合AvatarProps的联合类型要求。

强制要求label和onClick成对出现

如果需要在入参阶段就拦住“单独传label、单独传onClick”的错误写法,可以显式定义工厂函数的入参类型,替换泛型自动推导的Partial结构:

type AvatarFactoryInput = 
  // 纯展示分支:仅允许传公共属性
  Partial<AvatarOnlyProps>
  // 可点击分支:公共属性可选,但label和onClick必须同时提供
  | (Partial<AvatarOnlyProps> & Pick<ClickableAvatarProps, 'label' | 'onClick'>);

// 替换Avatar对应的工厂类型
type AvatarFactory = (state?: AvatarFactoryInput) => AvatarProps;

加上这个约束后,TS 会在入参校验阶段直接拦截不合规的写法,从类型层面保证两个属性要么同时提供,要么都不出现。

内容的提问来源于stack exchange,提问作者J. Hesters

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.08 19:24:10