为何已定义默认值的TypeScript类静态选项仍可能为undefined？

我尝试为类预定义静态选项：

interface Options {
    startTimeLimit?: number;
    throttlePeriod?: number;
    // 其他选项...
}
export class Draggable extends DragElement{
    static init(parentId:string, draggables:NodeList, options:Options) {
      Draggable.options = {
        startTimeLimit: 250,
        throttlePeriod: 100,
        // 其他默认值...
      }
      Object.assign(Draggable.options, options);
      // 其他初始化逻辑...
    }
    // 其他类逻辑...
}

但在使用这些选项时出现类型错误：

'Draggable.options.startTimeLimit' is possibly 'undefined'

使用示例：

var now = e.timeStamp;
if (now - Draggable.lastStartDragTime < Draggable.options.startTimeLimit) {
    // 防抖逻辑
    return false;
}

我理解?运算符允许客户端选择是否传入选项，但我已设置默认值，为何仍出现该错误？

补充说明 #

经过思考，我明白TypeScript无法确认init方法是否被调用，因此无法确定变量已定义，导致编译错误。但我仍想知道如何实现允许客户端不传入选项的需求。由于我明确init()一定会被调用（否则无法使用该库），是否可以直接对这些变量使用!非空断言运算符？

解决方案 #

1. 拆分类型定义，明确必填/可选边界 #

问题核心在于Draggable.options的类型被推断为包含可选属性的Options，但初始化后所有属性都有实际值。可以拆分出两个类型：一个供外部传入的可选配置接口，一个类内部使用的必填完整配置类型：

// 类内部使用的完整必填配置
interface FullOptions {
    startTimeLimit: number;
    throttlePeriod: number;
    // 其他必填选项...
}

// 供外部传入的可选配置，复用FullOptions的字段
interface Options extends Partial<FullOptions> {}

export class Draggable extends DragElement{
    // 显式声明静态属性为必填类型
    static options: FullOptions;

    static init(parentId:string, draggables:NodeList, options:Options = {}) {
      // 用展开运算符合并默认值和用户选项，替代Object.assign
      Draggable.options = {
        startTimeLimit: 250,
        throttlePeriod: 100,
        // 其他默认值...
        ...options
      };
      // 其他初始化逻辑...
    }
}

这样TypeScript会明确知道Draggable.options的所有属性都已被初始化，不会再提示undefined，同时保留了客户端不传参的灵活性。

2. 使用非空断言运算符（!） #

如果能100%保证init()一定会在使用options前被调用，直接用非空断言是最简单的方式：

if (now - Draggable.lastStartDragTime < Draggable.options.startTimeLimit!) {
    // 防抖逻辑
    return false;
}

但这种方式相当于跳过TypeScript的类型检查，若后续代码逻辑变更导致init()未被调用，会隐藏运行时错误，需谨慎使用。

3. 强制初始化约束 #

通过私有化构造函数+静态工厂方法的方式，强制用户必须通过init完成初始化，从根源上避免未初始化的情况：

export class Draggable extends DragElement{
    static options: FullOptions;
    // 私有化构造函数，禁止直接实例化
    private constructor() {
        super();
    }

    static init(parentId:string, draggables:NodeList, options:Options = {}) {
      Draggable.options = {
        startTimeLimit: 250,
        throttlePeriod: 100,
        ...options
      };
      // 若需要创建实例，在这里返回
      return new Draggable();
    }
}

用户只能通过Draggable.init()来使用类，确保options一定被初始化。

内容的提问来源于stack exchange，提问作者quilkin