Jest：如何在超时时终止异步测试？

问题背景 #

配置Jest测试超时时间为1000ms后，执行耗时2000ms的异步任务时，Jest会标记测试失败，但异步任务仍会继续执行，导致后续的expect和console.log在测试结束后运行，触发额外警告。需要实现超时后直接终止后续代码执行，消除警告。

当前测试代码 #

describe('timeout', () => {
    jest.setTimeout(1000);

    test('timeout', async () => {
        // 模拟长时间运行任务
        await new Promise((resolve) => setTimeout(resolve, 2000));

        // 长时间任务后的后续工作
        expect(true).toBeTruthy();
        console.log('waited 2s');
    });
});

当前执行问题 #

测试超时后，异步任务仍会完成，后续代码执行时触发Jest警告：

●  测试结束后无法记录日志。您是否忘记等待测试中的异步操作？
    尝试记录"waited 2s"。

解决方案：用Promise.race同步内部超时逻辑 #

由于Jest未提供测试内部检测超时状态的API，我们可以通过Promise.race让异步任务与一个和Jest超时时间一致的拒绝Promise竞争，超时后直接终止任务执行，避免后续代码运行。

修改后的测试代码：

describe('timeout', () => {
    const TEST_TIMEOUT = 1000;
    jest.setTimeout(TEST_TIMEOUT);

    test('timeout', async () => {
        // 创建与Jest超时同步的拒绝Promise
        const timeoutReject = new Promise((_, reject) => {
            setTimeout(() => reject(new Error('测试超时')), TEST_TIMEOUT);
        });

        // 让长任务与超时Promise竞争
        await Promise.race([
            // 模拟长时间运行任务
            new Promise((resolve) => setTimeout(resolve, 2000)),
            timeoutReject
        ]);

        // 超时后这段代码不会执行
        expect(true).toBeTruthy();
        console.log('waited 2s');
    });
});

效果说明 #

执行修改后的代码后，当超时时间到达，timeoutReject会先触发拒绝，Promise.race直接抛出错误，测试函数后续代码完全不会执行，也就不会出现测试结束后执行代码的警告，完全符合期望效果。

关于检测Jest超时状态 #

Jest的超时机制是由测试运行器在外部监控的，测试代码内部无法直接获取Jest是否已触发超时的状态。因此，同步内部超时逻辑与Jest的超时时间是最可靠的实现方式。

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