扩展属性包Interface并为各抽象层级配置默认值的最佳实现方案是什么

开发者阿泽

2026-10-1

核心思路

TypeScript 接口仅提供编译期的类型约束，不存在运行时实体，因此你需要在公共父类的构造阶段显式合并各层级预置的默认值与用户传入的自定义参数，同时配套调整类型定义保证类型安全。

具体实现

第一步：调整公共通用层代码

import { LibraryThing, LibraryThingProps, LibraryCommunicationProps } from '外部库路径';

// 预置公共层固定默认值
const PACKAGE_COMMON_DEFAULTS = {
  org: 'MyOrg',
  communicationProps: {
    email: 'my-email@package.com'
  }
} as const;

// 定义公共类入参类型：仅要求传入差异化必填参数，允许覆盖默认值
export type PackageThingCommonProps = Omit<LibraryThingProps, 'org' | 'communicationProps'> & {
  org?: typeof PACKAGE_COMMON_DEFAULTS.org;
  communicationProps?: Partial<LibraryCommunicationProps>;
};

export class PackageThingCommon extends LibraryThing {
  constructor(id: string, props: PackageThingCommonProps) {
    // 深度合并默认值与传入参数，避免覆盖用户传入的自定义字段
    const mergedProps: LibraryThingProps = {
      ...PACKAGE_COMMON_DEFAULTS,
      ...props,
      communicationProps: {
        ...PACKAGE_COMMON_DEFAULTS.communicationProps,
        ...props.communicationProps
      }
    };
    super(id, mergedProps);
  }
}

第二步：业务代码无需修改

你现有业务层的SausageThing代码可以直接复用，运行时传入LibraryThing的参数会自动合并为符合要求的结构：

class SausageThing extends PackageThingCommon {
  constructor(id: string) {
    super('Sausage', {
      name: 'MyName', 
      communicationProps: {
        phone: '555-1234'
      }
    });
    // 其他业务逻辑
  }
}

const sausage = new SausageThing('my-id');