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
相关产品推荐
相关产品推荐

