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

Optimistic update и хук useOptimistic

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

Оптимистичное обновление — изменение UI до ответа сервера, как будто запрос уже прошел успешно. Если сервер вернул ошибку, изменение откатывают и показывают сообщение. Так интерфейс ощущается мгновенным: лайк, добавление в корзину, отправка сообщения. В React 19 для этого есть хук useOptimistic, в TanStack Query — onMutate с откатом в onError.

Вопрос

Что такое optimistic update? Как его реализовать вручную, через TanStack Query и через useOptimistic в React 19?

Основная идея

Обычно:         клик → запрос → ждем 500 мс → UI обновлен
Оптимистично:   клик → UI обновлен сразу → запрос → (ошибка? → откат)

useOptimistic (React 19)

import { useOptimistic } from "react";
 
function Thread({ messages, sendMessage }) {
  const [optimisticMessages, addOptimistic] = useOptimistic(
    messages,
    (state, newText) => [...state, { id: crypto.randomUUID(), text: newText, sending: true }],
  );
 
  async function formAction(formData) {
    const text = formData.get("text");
    addOptimistic(text);          // сразу показываем сообщение
    await sendMessage(text);      // настоящий запрос; после него messages обновятся
  }
 
  return (
    <>
      {optimisticMessages.map((m) => (
        <p key={m.id} style={{ opacity: m.sending ? 0.5 : 1 }}>{m.text}</p>
      ))}
      <form action={formAction}>
        <input name="text" />
        <button>Отправить</button>
      </form>
    </>
  );
}
  • useOptimistic(state, updateFn) возвращает оптимистичное состояние и функцию добавления;
  • оптимистичное значение живет, пока выполняется Action или transition;
  • после завершения React показывает реальный state — при ошибке изменение исчезнет само.

TanStack Query

const queryClient = useQueryClient();
 
useMutation({
  mutationFn: toggleLike,
  onMutate: async (postId) => {
    await queryClient.cancelQueries({ queryKey: ["post", postId] });
    const previous = queryClient.getQueryData(["post", postId]);
    queryClient.setQueryData(["post", postId], (p) => ({ ...p, liked: !p.liked, likes: p.likes + (p.liked ? -1 : 1) }));
    return { previous };                         // контекст для отката
  },
  onError: (_err, postId, context) => {
    queryClient.setQueryData(["post", postId], context.previous); // откат
  },
  onSettled: (_data, _err, postId) => {
    queryClient.invalidateQueries({ queryKey: ["post", postId] }); // синхронизация с сервером
  },
});

Когда применять

ПодходитНе подходит
лайки, избранное, отметки «прочитано»платежи, заказы
добавление комментария, сообщенияоперации с высокой вероятностью отказа
перетаскивание, сортировкадействия с необратимыми последствиями
переключатели настроеккогда сервер вычисляет результат (цена со скидкой)

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

  • Всегда предусматривайте откат и понятное сообщение об ошибке.
  • Временные id заменяйте на настоящие из ответа сервера.
  • Отменяйте текущие запросы перед оптимистичным обновлением, чтобы фоновый refetch не перезаписал его.
  • Повторные клики: мутации лучше делать идемпотентными.

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

Optimistic update: UI меняется до ответа, при ошибке — откат. React 19: useOptimistic(state, update) внутри Action. TanStack Query: onMutate (снимок + обновление кеша) → onError (откат) → onSettled (инвалидация). Не для платежей.

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

React: useOptimistic, TanStack Query: Optimistic Updates.

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

Поиск

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