Sinon Clock中tick与tickAsync方法的差异及适用场景解析

我完全理解你的困惑——Jest的fake timer方法有时候确实容易搞混，尤其是官方文档没把场景讲透的时候。让我用具体的例子帮你理清clock.tick()和clock.tickAsync()的核心区别和适用场景：

两者都是用来推进Jest模拟时间的方法，但核心差异在于对异步微任务的处理方式：

• clock.tick()是同步方法：推进时间后会立即执行所有到期的同步定时回调，但不会等待任何异步微任务（比如Promise.then、await后的逻辑）完成。
• clock.tickAsync()是异步方法：推进时间后，会等待所有微任务队列清空，返回一个Promise，必须配合async/await使用，确保异步逻辑完全执行后再进行后续操作。

下面用两个典型场景对比说明：

1. 使用clock.tick()：纯同步定时回调 #

当你的定时任务回调是纯同步逻辑时，clock.tick()足够高效且简洁：

test('clock.tick() works for synchronous setTimeout callbacks', () => {
  jest.useFakeTimers();
  const logMock = jest.fn();

  // 定义一个同步的定时回调
  setTimeout(() => {
    logMock('1 second passed');
  }, 1000);

  // 同步推进时间1秒
  jest.advanceTimersByTime(1000); // 和 clock.tick(1000) 功能等价

  // 立即断言：同步回调已经执行
  expect(logMock).toHaveBeenCalledWith('1 second passed');
  expect(logMock).toHaveBeenCalledTimes(1);

  jest.useRealTimers();
});

2. 使用clock.tickAsync()：包含异步逻辑的定时回调 #

如果你的定时回调里有Promise、async/await这类异步操作，clock.tick()会因为不等待微任务导致断言失败，此时必须用clock.tickAsync()：

test('clock.tickAsync() handles async callbacks correctly', async () => {
  jest.useFakeTimers();
  const mockApiCall = jest.fn(() => Promise.resolve({ data: 'success' }));
  let apiResult = null;

  // 定义一个包含异步逻辑的定时回调
  setTimeout(async () => {
    const response = await mockApiCall();
    apiResult = response.data;
  }, 1500);

  // ❌ 如果用clock.tick(1500)，会执行回调但不会等待Promise完成
  // jest.advanceTimersByTime(1500);
  // expect(apiResult).toBe('success'); // 断言失败，因为Promise微任务还没执行

  // ✅ 改用tickAsync，配合await等待所有异步逻辑完成
  await jest.advanceTimersByTimeAsync(1500); // 和 await clock.tickAsync(1500) 功能等价

  // 此时Promise已经resolve，apiResult被正确赋值
  expect(apiResult).toBe('success');
  expect(mockApiCall).toHaveBeenCalledTimes(1);

  jest.useRealTimers();
});

• 用clock.tick()：当定时回调是纯同步代码（无Promise、async/await等异步操作），不需要等待微任务时。
• 用clock.tickAsync()：当定时回调包含异步逻辑，或者你需要确保所有异步副作用（比如API模拟、状态更新）完全完成后再做断言时。

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