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

Transitions: useTransition и startTransition

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

Transition — обновление состояния, помеченное как несрочное. React выполняет его с низким приоритетом и может прервать, если пришло срочное обновление (ввод, клик). useTransition() возвращает [isPending, startTransition]: флаг ожидания и функцию, внутри которой вызываются сеттеры. Отдельная функция startTransition из react делает то же самое без флага — ее можно вызывать вне компонентов. Transitions — часть Concurrent Rendering из React 18.

Вопрос

Что такое transition updates? Что делают useTransition() и startTransition() и чем они отличаются?

Проблема

function Search() {
  const [query, setQuery] = useState("");
  const [results, setResults] = useState([]);
 
  const handleChange = (e) => {
    setQuery(e.target.value);
    setResults(filterHugeList(e.target.value)); // тяжелый рендер блокирует ввод
  };
}

Пока React рендерит тысячи результатов, поле ввода «залипает».

useTransition

import { useState, useTransition } from "react";
 
function Search() {
  const [query, setQuery] = useState("");
  const [results, setResults] = useState([]);
  const [isPending, startTransition] = useTransition();
 
  const handleChange = (e) => {
    setQuery(e.target.value);              // срочно: поле обновится сразу
    startTransition(() => {
      setResults(filterHugeList(e.target.value)); // несрочно, можно прервать
    });
  };
 
  return (
    <>
      <input value={query} onChange={handleChange} />
      {isPending && <Spinner />}
      <ResultList items={results} />
    </>
  );
}

Если пользователь печатает дальше, React бросит незаконченный рендер результатов и начнет новый с актуальным query.

startTransition без хука

import { startTransition } from "react";
 
router.subscribe((url) => {
  startTransition(() => {
    setPage(url);  // вне компонента: в роутере, store, утилите
  });
});
useTransitionstartTransition
Где вызыватьв компоненте или хукегде угодно
isPendingестьнет
Применениеиндикатор ожидания в UIбиблиотеки, роутеры, store

Transitions и Suspense

Если обновление внутри transition вызывает приостановку (Suspense), React не показывает fallback для уже видимого контента, а оставляет старый экран, пока новый не будет готов. Так навигация не превращается в мигающий спиннер.

Async-transitions (React 19)

startTransition(async () => {
  const error = await updateName(name);
  if (error) setError(error);
  else startTransition(() => redirect("/profile"));
});

Функция может быть асинхронной: isPending остается true, пока Promise не завершится. На этом построены Actions и useActionState.

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

  • Внутри startTransition должны быть вызовы сеттеров; сам по себе тяжелый синхронный JS не станет прерываемым.
  • Управляемые поля ввода нельзя обновлять в transition — ввод должен быть срочным.
  • Transitions не замена debounce: они не уменьшают количество запросов к серверу.
  • Работают только с createRoot (конкурентный режим React 18+).

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

Transition = несрочное, прерываемое обновление. useTransition → [isPending, startTransition]. startTransition из react — без флага, вне компонентов. Срочное — ввод, несрочное — тяжелые списки и навигация. Не скрывает контент fallback-ом.

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

React: useTransition, React: startTransition, React 18: Transitions.

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

Поиск

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