Когда именно выполняется 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. - Логи показывают порядок вызовов, а не момент отрисовки.