JavaScript的setTimeout()是否可能提前触发？

我编写了一个用于创建异步超时的工具函数：

export function asyncTimeout(timeout: number): Promise<void> {
  return new Promise(resolve => setTimeout(resolve, timeout))
}

同时使用vitest编写了单元测试：

test('asyncTimeout', async ()=> {
  const start = Date.now()
  await asyncTimeout(10)
  const end = Date.now()
  expect(end - start).toBeGreaterThanOrEqual(10)
})

该测试大部分时候能通过，但偶尔会失败，报错信息为“AssertionError: expected 9 to be greater than or equal to 10”。请问这种情况是如何发生的？JavaScript的setTimeout()是否可能提前触发？

问题原因解析 #

• setTimeout不会提前触发：JavaScript规范明确要求setTimeout的回调绝不会在指定延迟时间之前执行，不存在提前触发的情况。
• Date.now()的精度限制：Date.now()返回毫秒级时间戳，但多数系统的时钟精度并非严格1毫秒，可能存在1-2毫秒的误差。比如start刚好取到某毫秒的末尾，end取到下一个毫秒的开头，实际时间差还未到10毫秒，但计算结果会显示为9毫秒。
• 测试环境的微小波动：在系统资源紧张或CI环境中，进程可能被短暂调度，但这种情况通常会让延迟时间变长，偶尔出现的9毫秒结果主要还是由时钟精度问题导致。

修复方案 #

可以通过两种方式优化测试：

1. 给时间差判断增加微小容错范围：

test('asyncTimeout', async ()=> {
  const start = Date.now()
  await asyncTimeout(10)
  const end = Date.now()
  expect(end - start).toBeGreaterThanOrEqual(9) // 允许1毫秒的精度误差
})

2. 使用精度更高的performance.now()替代Date.now()，它提供亚毫秒级精度，能更准确计算时间差：

test('asyncTimeout', async ()=> {
  const start = performance.now()
  await asyncTimeout(10)
  const end = performance.now()
  expect(end - start).toBeGreaterThanOrEqual(10)
})

内容的提问来源于stack exchange，提问作者Mohammad Javad Khademian