TypeScript跨平台重分配内置全局变量Date的报错解决问询

这个问题我之前在测试全局变量存根的时候也碰到过，TypeScript对全局内置对象的只读限制确实有点头疼。结合你的需求（跨平台、严格模式兼容），最靠谱的方案是用globalThis来操作全局变量——这是ES2020引入的标准全局对象，完美适配浏览器、Node.js、Web Worker等各种环境。

为什么直接赋值Date = bar()会报错？ #

TypeScript的内置类型定义里，全局的Date被标记为只读属性；如果你的代码在模块上下文里，TypeScript还会默认限制对全局变量的直接赋值，所以才会抛出Cannot assign to 'Date' because it is a constant or a read-only property的错误。

具体解决方案 #

方案1：快速实现（适合临时测试/调试） #

用globalThis配合类型断言绕过TypeScript的只读检查，这是最简单直接的方式，完全跨平台且兼容严格模式：

function bar(): DateConstructor {
  // 模拟你需要的存根Date构造函数
  return class MockDate extends Date {
    static now() {
      return 1234567890;
    }
  };
}

function foo() {
  // 用as any让TypeScript允许修改全局Date
  (globalThis as any).Date = bar();
}

foo();
console.log(Date.now()); // 输出 1234567890

globalThis是标准的全局对象入口，不用再判断当前环境是window还是global，严格模式下也不会像this['Date']那样因为this为undefined而报错。

方案2：类型安全的长期方案 #

如果你的测试代码需要更严格的类型检查，不想用any，可以扩展全局类型定义：

1. 在项目根目录创建一个global.d.ts文件（TypeScript会自动识别这个类型声明文件）：

declare global {
  // 重新声明Date为可写的全局变量
  var Date: DateConstructor;
}

// 必须加这行，让文件成为模块
export {};

2. 之后在代码里就可以直接通过globalThis赋值，不用类型断言了：

function foo() {
  globalThis.Date = bar();
}

额外提醒：测试后记得恢复全局变量 #

修改全局内置对象会影响整个运行环境，所以在测试用例执行完后，一定要恢复原来的Date，避免测试用例之间互相污染：

// 保存原始的Date构造函数
const originalDate = Date;

function foo() {
  (globalThis as any).Date = bar();
}

// 比如在Jest的afterEach钩子中恢复
afterEach(() => {
  (globalThis as any).Date = originalDate;
});

这样就能安全地在测试中存根全局Date，同时满足跨平台和严格模式的要求。

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