re:re:actable
Урок 111 минута чтения

Что делает requestIdleCallback()?

На этой странице
Кратко

requestIdleCallback() планирует некритичную работу на момент, когда браузер свободен.

Вопрос

Для чего нужен requestIdleCallback() и почему его нельзя использовать для важных задач?

Определение

requestIdleCallback(callback, options) просит браузер выполнить callback в свободное время, когда нет срочных задач вроде ввода пользователя, скриптов и отрисовки кадра.

Метод подходит для фоновой работы, которую можно отложить без вреда для UX.

Пример

requestIdleCallback((deadline) => {
  while (deadline.timeRemaining() > 0 && tasks.length > 0) {
    const task = tasks.shift();
    processTask(task);
  }
});

Callback получает объект deadline, который помогает понять, сколько времени примерно осталось.

deadline

requestIdleCallback((deadline) => {
  console.log(deadline.timeRemaining());
  console.log(deadline.didTimeout);
});

timeRemaining() возвращает примерное количество миллисекунд до конца свободного окна.

didTimeout будет true, если callback вызван из-за истечения timeout.

Опция timeout

requestIdleCallback(doBackgroundWork, {
  timeout: 2000,
});

timeout задает максимальное ожидание. Если свободного времени долго нет, браузер все равно вызовет callback после указанного срока.

Когда использовать

  • предзагрузка данных;
  • логирование;
  • аналитика;
  • подготовка кэша;
  • обработка большого списка небольшими частями.

Когда не использовать

  • критичные UI-обновления;
  • анимации;
  • действия, которые должны выполниться строго вовремя.

Что важно помнить

  • requestIdleCallback выполняет низкоприоритетную работу, когда у браузера есть свободное время в кадре.
  • Колбэк получает deadline.timeRemaining() — делайте работу порциями и не превышайте лимит.
  • Опция timeout гарантирует выполнение, даже если браузер постоянно занят.
  • Safari долго не поддерживал rIC — нужен fallback на setTimeout; новая альтернатива — Scheduler API (scheduler.postTask).

Мини-шпаргалка

const id = requestIdleCallback(callback, { timeout: 1000 });
cancelIdleCallback(id);

Документация

MDN: requestIdleCallback(), MDN: Prioritized Task Scheduling API.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам