Vitest中Intl全局对象替换导致useFakeTimers崩溃问题解析

在JavaScript测试框架Vitest的使用过程中，开发者可能会遇到一个与国际化API(Intl)相关的特殊问题。当尝试替换全局Intl对象后调用useFakeTimers时，会导致程序崩溃并抛出"TypeError: Cannot read properties of undefined (reading 'prototype')"错误。

问题现象

该问题表现为以下几种情况：

1. 崩溃场景：当开发者使用扩展运算符(...)创建Intl对象的浅拷贝并替换全局Intl后，再调用useFakeTimers会导致崩溃
2. 正常场景：如果先调用useFakeTimers再替换Intl，或者直接替换为原始Intl对象而不进行拷贝，则不会出现问题

根本原因分析

深入分析后发现，问题根源在于Vitest内部实现fake timers时对Intl.DateTimeFormat.prototype的依赖。当开发者使用扩展运算符创建Intl对象的浅拷贝时，会丢失原型链信息，导致：

1. 浅拷贝后的Intl.DateTimeFormat不再保持原始原型链
2. Vitest内部尝试访问NativeIntl.DateTimeFormat.prototype时得到undefined
3. 在尝试使用Object.create创建新原型时崩溃

解决方案

对于遇到此问题的开发者，有以下几种解决方案：

方案一：完整保留原型链的替换

const UntouchedIntl = Intl;
const UntouchedIntlDescriptors = Object.getOwnPropertyDescriptors(Intl);

test("测试用例", () => {
  const NewIntl = {};
  Object.defineProperties(NewIntl, {
    ...UntouchedIntlDescriptors,
    NumberFormat: {
      ...UntouchedIntlDescriptors.NumberFormat,
      value: class extends UntouchedIntl.NumberFormat {
        // 自定义实现
      }
    }
  });
  vi.stubGlobal("Intl", NewIntl);
  vi.useFakeTimers();
});

方案二：修改原型链的全局方案

// 在测试配置文件中
Intl.NumberFormat = class extends Intl.NumberFormat {
  // 自定义实现
};

技术建议

1. 原型链完整性：在替换全局对象时，特别是像Intl这样的内置对象，必须注意保持原型链的完整性
2. 执行顺序：在测试中，fake timers的初始化可能依赖于某些全局对象的状态，应注意API调用的顺序
3. 浅拷贝陷阱：扩展运算符(...)对于复制具有原型链的对象可能不够充分，应考虑使用Object.create或class extends等保持原型链的方法

框架设计考量

从Vitest框架设计角度看，这个问题反映了fake timers实现中对全局对象状态的隐式依赖。理想的解决方案可能是：

1. 在初始化阶段捕获关键内置对象的原始引用
2. 避免在后续操作中依赖可能被修改的全局状态
3. 提供更明确的错误提示，帮助开发者快速定位问题原因

通过理解这一问题及其解决方案，开发者可以更安全地在测试中处理Intl等全局对象的修改，同时也能更深入地理解JavaScript原型链和全局状态管理的重要性。