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

React 19.2: Activity, useEffectEvent и cacheSignal

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

React 19.2 (октябрь 2025) добавил три API, которые часто спрашивают. <Activity mode="visible" | "hidden"> скрывает часть UI без размонтирования: состояние и DOM сохраняются, эффекты в скрытом дереве отключаются, а обновления рендерятся с низким приоритетом — удобно для вкладок, возврата на экран и предрендера следующего шага. useEffectEvent создаёт функцию-«событие эффекта», которая всегда видит свежие props и state, но не является зависимостью эффекта — решение старой проблемы «эффект переподключается из-за значения, которое нужно только прочитать». cacheSignal (Server Components) возвращает AbortSignal, который срабатывает, когда закончилось время жизни cache() — можно отменять ненужную работу. Плюс Performance Tracks в Chrome DevTools и API частичного пререндера (prerender/resume) в react-dom/server.

Вопрос

Что появилось в React 19.2? Как работают Activity и useEffectEvent и какие проблемы они решают?

Activity: скрыть, не теряя состояние

import { Activity, useState } from 'react';
 
export function Library() {
  const [tab, setTab] = useState('catalog');
 
  return (
    <>
      <nav>
        <button onClick={() => setTab('catalog')}>Каталог</button>
        <button onClick={() => setTab('reading')}>Читаю сейчас</button>
      </nav>
 
      <Activity mode={tab === 'catalog' ? 'visible' : 'hidden'}>
        <Catalog />   {/* фильтры, скролл, введённый поиск сохраняются */}
      </Activity>
      <Activity mode={tab === 'reading' ? 'visible' : 'hidden'}>
        <Reader />
      </Activity>
    </>
  );
}
СпособСостояниеЭффекты в скрытомПриоритет фоновых обновлений
{show && <X />}ТеряетсяУдаляются—
CSS display: noneСохраняетсяПродолжают работатьОбычный
<Activity mode="hidden">СохраняетсяCleanup вызван, запустятся при показеНизкий

Скрытое дерево может предрендериться заранее: например, следующий шаг формы или вероятная вкладка загружают код и данные (через Suspense-совместимые источники), пока пользователь занят текущим экраном. В Next.js с Cache Components роутер использует Activity, чтобы сохранять состояние предыдущих страниц при навигации назад.

useEffectEvent: читать свежие значения без перезапуска эффекта

Проблема:

function ChatRoom({ roomId, theme }) {
  useEffect(() => {
    const conn = connect(roomId);
    conn.on('connected', () => showToast('Подключено', theme));
    return () => conn.disconnect();
  }, [roomId, theme]); // смена темы → переподключение к чату ✗
}

Убрать theme из зависимостей нельзя: линтер прав — эффект увидит устаревшую тему.

Решение:

import { useEffect, useEffectEvent } from 'react';
 
function ChatRoom({ roomId, theme }) {
  const onConnected = useEffectEvent(() => {
    showToast('Подключено', theme); // всегда актуальная тема
  });
 
  useEffect(() => {
    const conn = connect(roomId);
    conn.on('connected', onConnected);
    return () => conn.disconnect();
  }, [roomId]); // переподключение только при смене комнаты ✓
}

Правила:

  • Вызывать событие эффекта только из эффектов (и других событий эффектов), не из рендера и не передавать в другие компоненты.
  • Не включать его в массив зависимостей — линтер react-hooks это знает.
  • Это не замена useCallback для обработчиков кликов.

Типичные кейсы: аналитика с текущими параметрами, обработчики подписок, логирование с актуальным состоянием, таймеры, которым нужно последнее значение.

cacheSignal: отмена работы на сервере

import { cache, cacheSignal } from 'react';
 
const getBook = cache(async (id) => {
  const res = await fetch(`https://api.example.com/books/${id}`, { signal: cacheSignal() });
  return res.json();
});

Когда рендер завершён, прерван или упал, сигнал отменяет запросы, результаты которых уже никто не прочитает. Работает только в Server Components.

Performance Tracks

В панели Performance Chrome DevTools появились дорожки React:

  • Scheduler — какие обновления выполнялись и с каким приоритетом (Blocking, Transition, Idle), сколько ждали и рендерились;
  • Components — какие компоненты рендерились, монтировались и сколько заняли эффекты.

Это позволяет видеть работу React рядом с сетью, layout и сторонними скриптами в одном профиле.

Частичный пререндер (для фреймворков)

prerender из react-dom/static может отдать статическую оболочку и состояние «откладывания», а resume из react-dom/server — продолжить рендер динамических частей на запросе. Это низкоуровневая основа PPR, которую используют фреймворки вроде Next.js.

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

<Activity mode="visible|hidden"> — скрыть без размонтирования, эффекты выключены, низкий приоритет
useEffectEvent(fn) — свежие props/state в эффекте без зависимости
cacheSignal() — AbortSignal для cache() в RSC
Performance Tracks — Scheduler и Components в Chrome DevTools
prerender/resume — основа частичного пререндера

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

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

Поиск

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