Фейковые таймеры

~3 минуты · 3 примера · 3 вопроса

Урок учит тестировать код с setTimeout/setInterval без реального ожидания времени.

Фейковые таймеры подменяют setTimeout/setInterval, давая тесту управлять «временем» вручную.

Проблема настоящего времени

Код с setTimeout(fn, 5000) нельзя честно тестировать, ожидая 5 секунд: тесты должны быть быстрыми. И от реального времени они становятся недетерминированными. Решение — фейковые таймеры: время «перематывает» сам тест.

Включение фейковых таймеров

jest.useFakeTimers();

test('колбэк вызывается через 1 секунду', () => {
  const cb = jest.fn();

  setTimeout(cb, 1000);

  expect(cb).not.toHaveBeenCalled();   // время ещё не прошло

  jest.advanceTimersByTime(1000);      // перематываем 1 секунду

  expect(cb).toHaveBeenCalledTimes(1); // теперь вызвался
});

Тест выполняется мгновенно, хотя «логически» прошла секунда.

Полезные методы

МетодЧто делает
advanceTimersByTime(ms)перематывает время на ms миллисекунд
runAllTimers()выполняет все ожидающие таймеры
runOnlyPendingTimers()выполняет только текущие (без новых, созданных ими)
useRealTimers()возвращает настоящие таймеры

Идея «виртуального времени» на чистом JS

Смоделируем перемотку времени без реального ожидания:

// мини-планировщик с виртуальными часами
const queue = [];
let now = 0;

function schedule(fn, delay) {
  queue.push({ time: now + delay, fn });
}
function advance(ms) {
  now += ms;
  queue.filter(t => t.time <= now).forEach(t => t.fn());
}

let called = false;
schedule(() => { called = true; }, 1000);

console.log('сразу после schedule, called =', called);
advance(1000); // "перематываем" 1 секунду
console.log('после advance(1000), called =', called);
Ожидаемый вывод
сразу после schedule, called = false
после advance(1000), called = true

Именно так и работают фейковые таймеры Jest: задачи лежат в очереди с «временем срабатывания», а advanceTimersByTime двигает виртуальные часы и выполняет всё, что подошло.

Не забывайте откатить

После теста с фейковыми таймерами их сбрасывают, чтобы не сломать соседние тесты:

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

Итог

  • jest.useFakeTimers() подменяет таймеры, чтобы не ждать реальное время.
  • advanceTimersByTime(ms) перематывает время и выполняет наступившие колбэки.
  • Тест становится быстрым и детерминированным.
  • После — useRealTimers() для изоляции.

Проверь себя

Три вопроса по уроку. Ответы никуда не идут — это для тебя.

1Зачем нужны фейковые таймеры?

2Что делает jest.advanceTimersByTime(1000)?

3Почему после теста с фейковыми таймерами вызывают useRealTimers()?

Следующий урок
17 · Что именно тестировать Открыть урок 17
Урок 15: Мок модулей и шпионы