re:re:actable
Урок 094 минуты чтения

Когда именно выполняется useEffect

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

Популярная схема «render → commit → браузер рисует → useEffect» верна в большинстве случаев, но не всегда. useEffect — пассивный эффект: React гарантирует только, что он выполнится после commit (DOM уже обновлён) и до следующего рендера этого компонента. Обычно React откладывает пассивные эффекты, чтобы браузер успел нарисовать кадр. Но если обновление вызвано дискретным действием пользователя (клик, нажатие клавиши) или useLayoutEffect вызвал новое обновление, React может выполнить эффекты синхронно, до отрисовки, — чтобы результат действия был согласованным. Поэтому: если код обязан выполниться до показа кадра (измерение и позиционирование) — useLayoutEffect; если важно не блокировать отрисовку — useEffect, но без расчёта на точный момент.

Вопрос

Правда ли, что useEffect всегда выполняется после того, как браузер нарисовал кадр? Почему на это нельзя полагаться?

Обычный сценарий

setState (например, ответ сервера, таймер)
  → render: вызов компонентов
  → commit: изменения DOM, ref
  → useLayoutEffect (синхронно)
  → браузер рисует кадр          ← пользователь видит обновление
  → useEffect                    ← запланирован после отрисовки

Так React не задерживает показ интерфейса ради эффектов вроде подписок и логирования.

Когда useEffect выполняется до отрисовки

Клик пользователя → setState
  → render → commit
  → useLayoutEffect
  → useEffect выполняется СРАЗУ (синхронно), до кадра
  → браузер рисует
СитуацияКогда выполняется useEffect
Обновление из таймера, ответа сети, transitionОбычно после отрисовки
Дискретный ввод: клик, keydown, submitМожет выполниться синхронно до отрисовки
useLayoutEffect вызвал setStateОжидающие пассивные эффекты выполняются до нового рендера
Новый рендер начинается раньше, чем эффекты успели выполнитьсяReact сначала «доделает» эффекты предыдущего commit

Зачем React так делает: после клика результат (включая эффекты) должен быть согласован до следующего действия пользователя — иначе второй клик мог бы обработаться в «полуобновлённом» состоянии.

Что из этого следует на практике

// ✗ Полагаться, что useEffect успеет после кадра — для позиционирования
function Tooltip({ anchorRect, text }) {
  const ref = useRef(null);
  const [top, setTop] = useState(0);
  useEffect(() => {
    setTop(anchorRect.top - ref.current.offsetHeight); // иногда видно «прыжок»
  }, [anchorRect]);
  return <div ref={ref} style={{ top }}>{text}</div>;
}
 
// ✓ Работа, обязательная до показа кадра, — в useLayoutEffect
useLayoutEffect(() => {
  setTop(anchorRect.top - ref.current.offsetHeight);
}, [anchorRect]);
// ✗ Ожидать, что тяжёлая работа в useEffect «не помешает» интерфейсу
useEffect(() => {
  heavyCalculation(); // 300 мс — после клика может выполниться до отрисовки и заблокировать её
}, [data]);
 
// ✓ Тяжёлое — вне основного потока или с уступанием потока
useEffect(() => {
  const worker = new Worker(new URL("./calc.worker.js", import.meta.url));
  worker.postMessage(data);
  worker.onmessage = (e) => setResult(e.data);
  return () => worker.terminate();
}, [data]);

Эксперимент: порядок вызовов

import { useEffect, useLayoutEffect, useRef, useState } from "react";
 
export default function PhaseLog() {
  const [count, setCount] = useState(0);
  const ref = useRef<HTMLParagraphElement>(null);
 
  console.log("1. render", count);
 
  useLayoutEffect(() => {
    console.log("2. layout effect, DOM уже:", ref.current?.textContent);
  }, [count]);
 
  useEffect(() => {
    console.log("3. passive effect", count);
  }, [count]);
 
  return (
    <>
      <p ref={ref}>Клики: {count}</p>
      <button onClick={() => setCount((c) => c + 1)}>Клик</button>
    </>
  );
}

Порядок 1 → 2 → 3 гарантирован. А вот был ли кадр нарисован между 2 и 3 — по консоли не определить. Это видно только в Chrome DevTools → Performance (дорожки Frames и Main).

Какой эффект выбрать

ЗадачаХук
Подписка, таймер, запрос, аналитика, синхронизация с внешней системойuseEffect
Измерить DOM и изменить раскладку без миганияuseLayoutEffect
Восстановить позицию прокрутки до показаuseLayoutEffect
Вставить <style> до измерений (CSS-in-JS библиотеки)useInsertionEffect
Реакция на действие пользователяОбработчик события, не эффект

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

  • Гарантия useEffect: после commit и до следующего рендера компонента; момент относительно отрисовки — не гарантирован.
  • Commit ≠ paint: DOM обновлён, но кадр может быть ещё не показан.
  • Обязательная до кадра работа — useLayoutEffect (и она должна быть короткой).
  • Тяжёлые вычисления не становятся «неблокирующими» от переноса в useEffect.
  • Эффекты не запускаются для отброшенных рендеров (concurrent) — только для зафиксированных.

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

  • Обычно: render → commit → paint → useEffect.
  • После клика: эффект может выполниться до paint.
  • До кадра обязательно → useLayoutEffect.
  • Логи показывают порядок вызовов, а не момент отрисовки.

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

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

Поиск

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