fakeTimers

• 类型: FakeTimerConfig

当使用 vi.useFakeTimers() 时，Vitest 会将此选项传递给 @sinon/fake-timers。

fakeTimers.now

• 类型: number | Date
• 默认值: Date.now()

使用指定的 Unix 时间戳安装假计时器。

fakeTimers.toFake

• 类型: ('setTimeout' | 'clearTimeout' | 'setImmediate' | 'clearImmediate' | 'setInterval' | 'clearInterval' | 'Date' | 'nextTick' | 'hrtime' | 'requestAnimationFrame' | 'cancelAnimationFrame' | 'requestIdleCallback' | 'cancelIdleCallback' | 'performance' | 'queueMicrotask' | 'Intl' | 'Temporal')[]
• 默认值: 全局可用的所有方法，除了 nextTick 和 queueMicrotask

需要模拟的全局方法和 API 名称数组。例如仅需模拟 setTimeout() 和 nextTick()，可将此属性指定为 ['setTimeout', 'nextTick']。

仅当全局对象上存在 Temporal 时，才会对其进行模拟：原生支持（Node.js ≥ 26 默认支持，旧版本需通过 --harmony-temporal 开启，或使用原生支持 Temporal 的浏览器），或通过全局安装的 polyfill 提供支持，例如 import 'temporal-polyfill/global'。

当使用 --pool=forks 在 node:child_process 中运行 Vitest 时，不支持模拟 nextTick。NodeJS 会在 node:child_process 内部使用 process.nextTick，模拟后会导致进程挂起。使用 --pool=threads 运行 Vitest 时支持模拟 nextTick。

fakeTimers.toNotFake

• 类型: ('setTimeout' | 'clearTimeout' | 'setImmediate' | 'clearImmediate' | 'setInterval' | 'clearInterval' | 'Date' | 'nextTick' | 'hrtime' | 'requestAnimationFrame' | 'cancelAnimationFrame' | 'requestIdleCallback' | 'cancelIdleCallback' | 'performance' | 'queueMicrotask' | 'Intl' | 'Temporal')[]
• 默认值: []

An array of global methods and APIs to exclude from fake timers. Vitest always excludes nextTick and queueMicrotask when this option is used. To fake either API, use toFake instead.

注意

不支持同时使用 toFake 和 toNotFake。

fakeTimers.loopLimit

• 类型: number
• 默认值: 10_000

调用 vi.runAllTimers() 时将运行的最大计时器数量。

fakeTimers.shouldAdvanceTime

• 类型: boolean
• 默认值: false

告诉 @sinonjs/fake-timers 根据真实系统时间的变化自动递增模拟时间（例如，真实系统时间变化 20ms 时，模拟时间也会递增 20ms）。

fakeTimers.advanceTimeDelta

• 类型: number
• 默认值: 20

仅在使用 shouldAdvanceTime: true 时相关。真实系统时间每变化 advanceTimeDelta 毫秒，模拟时间就会递增 advanceTimeDelta 毫秒。

fakeTimers.shouldClearNativeTimers

• 类型: boolean
• 默认值: true

指示假计时器通过委托给它们各自的处理函数来清除 “原生”（即非假）计时器。如果禁用此功能，当伪计时器会话启动前已存在计时器时，可能导致意外行为。