Как тестировать код с таймерами: fake timers в Jest и Vitest?
Тестовые инструменты
Fake timers заменяют setTimeout, setInterval и Date, чтобы тест управлял временем сам и не ждал по-настоящему.
Как использовать
vi.useFakeTimers();
const onSearch = vi.fn();
const debounced = debounce(onSearch, 300);
debounced('a');
vi.advanceTimersByTime(299);
expect(onSearch).not.toHaveBeenCalled();
vi.advanceTimersByTime(1);
expect(onSearch).toHaveBeenCalledWith('a');
vi.useRealTimers();Полезные методы
advanceTimersByTime(ms)двигает время вперёд.runAllTimers()выполняет все ожидающие таймеры.setSystemTime(date)фиксирует текущую дату.
Подводные камни
- После теста возвращайте реальные таймеры (
useRealTimers), иначе сломаются соседние тесты. - С промисами и таймерами вместе нужны асинхронные версии:
advanceTimersByTimeAsync. - В тестах с Testing Library
userEventтребует настроитьadvanceTimers.
Коротко для собеседования
Fake timers дают контроль над временем: двигаем часы вручную, тест быстрый и стабильный. Не забывайте вернуть реальные таймеры.
Подробнее: Vitest — Mocking: Timers