如何为globalThis上的类变量添加TypeScript类型定义？

你遇到的问题是因为错误地使用了module globalThis来声明全局类型，正确的做法是直接扩展globalThis接口。以下是两种可行的解决方案：

方案一：先定义类类型再关联到globalThis #

这种方式适合需要详细定义类成员（包括实例属性、方法和静态成员）的场景：

// 先定义类的完整类型（和你JS中实际的X类结构保持一致）
class XClass {
  value: string;
  constructor() {
    this.value = "示例值";
  }

  // 可根据实际需求添加更多类的方法或属性
  someMethod(): void {
    console.log("执行方法");
  }
}

// 扩展globalThis接口，声明X属性的类型
declare global {
  interface globalThis {
    X: typeof XClass;
  }
}

// 必须导出空对象，让TS将当前文件识别为模块（如果是在.d.ts声明文件中则不需要这行）
export {};

方案二：直接在globalThis接口中声明类类型 #

如果不想单独定义类，也可以直接在接口内描述类的构造函数和实例结构：

declare global {
  interface globalThis {
    X: {
      // 声明构造函数
      new(): {
        value: string;
        // 其他实例成员，比如方法
        someMethod(): void;
      };
      // 如果类有静态成员，在这里添加，比如：
      // static staticProp: number;
    };
  }
}

export {};

原有写法报错原因 #

• 第一种写法用var X = (class { ... })在module globalThis中：TS中globalThis是全局接口而非模块，不能用module关键字声明，且这种赋值式的声明不符合类型定义的语法规范。
• 第二种写法在module globalThis中声明class X：这会让TS认为X是该模块内部的类，而非挂载在全局globalThis上的属性，因此使用时会出现类型找不到的错误。

验证使用 #

完成类型声明后，使用时TS就能正确识别类型：

const x = new globalThis.X();
console.log(x.value); // TS不会报错，能正确推断value的类型
x.someMethod(); // 同样能识别方法类型

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