使用Jest测试带超时的Promise时断言失败却通过的问题排查

你遇到的核心问题是：测试函数没有等待Promise断言完成，Jest在Promise状态变更前就结束了测试，导致错误的断言仅抛出未处理拒绝警告，却不触发测试失败。以下是具体解决方案：

先确保正确配置假定时器 #

在测试前后切换假/真实定时器，避免影响其他测试：

beforeEach(() => {
  jest.useFakeTimers();
});

afterEach(() => {
  jest.useRealTimers();
});

方法1：使用async/await（推荐） #

将测试函数声明为async，通过await等待断言的Promise完成，确保Jest捕获到断言结果：

it("Should return the right ID", async () => {
  expect.assertions(1);
  const promise = promiseWithTimeout();
  jest.advanceTimersByTime(1000);
  await expect(promise).resolves.toEqual({id: 3}); // 正常通过
});

it("Should fail when ID doesn't match", async () => {
  expect.assertions(1);
  const promise = promiseWithTimeout();
  jest.advanceTimersByTime(1000);
  await expect(promise).resolves.toEqual({id: 4}); // 测试正确失败，提示对象不匹配
});

方法2：直接返回Promise #

如果不使用async/await，可直接返回断言的Promise，让Jest等待异步操作完成：

it("Should return the right ID", () => {
  expect.assertions(1);
  const promise = promiseWithTimeout();
  jest.advanceTimersByTime(1000);
  return expect(promise).resolves.toEqual({id: 3});
});

it("Should fail when ID doesn't match", () => {
  expect.assertions(1);
  const promise = promiseWithTimeout();
  jest.advanceTimersByTime(1000);
  return expect(promise).resolves.toEqual({id: 4}); // 测试正确失败
});

问题根源解释 #

你原代码的逻辑中，expect(promiseWithTimeout()).resolves.toEqual(...)会返回一个Promise，但测试函数没有等待这个Promise完成就结束了。Jest此时不会监听后续的Promise状态变更，导致断言失败仅变成未处理拒绝警告，无法触发测试失败。

通过await或返回Promise的方式，能强制Jest等待异步断言执行完毕，从而正确捕获断言结果，让符合预期的失败测试正常报错。

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