JS 项目中 setInterval 定时任务怎么进行单元测试-js教程-PHP中文网

js单元测试setinterval的核心是模拟定时器：调用jest.usefaketimers()隔离时间依赖，用jest.advancetimersbytime()控制执行节奏，验证回调行为与清理逻辑。

js 项目中 setinterval 定时任务怎么进行单元测试

在 JS 项目中对 setInterval 定时任务做单元测试，核心思路是**隔离时间依赖、控制定时器执行节奏、验证回调行为**，而不是真实等待时间流逝。主流测试框架（如 Jest、Vitest）都提供了模拟定时器的能力，这是最可靠的方式。

用 Jest/Vitest 模拟定时器（推荐）

Jest 和 Vitest 都内置了 jest.useFakeTimers()（Vitest 中为 vi.useFakeTimers()），它会替换全局的 setInterval、setTimeout 等为可控制的模拟版本。

调用 jest.useFakeTimers() 后，setInterval 不再真实触发，而是被记录下来
用 jest.advanceTimersByTime(ms) 快进指定毫秒，触发期间所有到期的定时器
用 jest.runAllTimers() 立即执行所有已设定但未触发的定时器（适合一次性清空）
测试结束后建议调用 jest.useRealTimers() 恢复，避免影响其他测试

测试一个典型的 setInterval 封装函数

假设你有这样一个工具函数：

dmap-jsapi-skill

DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。

下载

function startCounter(callback) {
  let count = 0;
  return setInterval(() => {
    count++;
    callback(count);
  }, 1000);
}

对应测试可写为：

describe('startCounter', () => {
  beforeEach(() => {
    jest.useFakeTimers();
  });

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

  it('should call callback with incremented count every second', () => {
    const mockCallback = jest.fn();
    const timerId = startCounter(mockCallback);

    // 初始状态：未触发
    expect(mockCallback).not.toHaveBeenCalled();

    // 快进 1000ms → 触发第 1 次
    jest.advanceTimersByTime(1000);
    expect(mockCallback).toHaveBeenCalledTimes(1);
    expect(mockCallback).toHaveBeenNthCalledWith(1, 1);

    // 再快进 1000ms → 触发第 2 次
    jest.advanceTimersByTime(1000);
    expect(mockCallback).toHaveBeenCalledTimes(2);
    expect(mockCallback).toHaveBeenNthCalledWith(2, 2);

    // 清理（可选）：清除定时器防止内存泄漏
    clearInterval(timerId);
  });
});