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

Работа с асинхронными операциями

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

Асинхронная операция (запрос к API, таймер, чтение файла) возвращает результат позже, а React рендерит интерфейс сейчас. Поэтому компонент должен описывать все состояния операции: загрузка, успех, ошибка (и часто — пусто). Результат попадает в интерфейс через обновление состояния, которое вызывает новый рендер. Где запускать операцию: загрузку при показе компонента — в useEffect (с отменой устаревших запросов), действие пользователя (сохранить, удалить) — в обработчике события, а в реальных проектах — через библиотеки и фреймворки (TanStack Query, SWR, loader маршрута, Server Components), которые берут на себя кэш, гонки и повторы. Подвохи: fetch не отклоняет промис на 404/500, клиентский компонент не может быть async, ответ старого запроса может перезаписать новый.

Вопрос

Как выполнять запросы к API в React и связывать их результат с интерфейсом?

Временная шкала запроса

Рендер 1: status = "loading"  → экран: «Загрузка…»
   └─ после commit useEffect запускает fetch(`/api/users/1`)
                    ⋮ 500 мс сеть ⋮
ответ пришёл → setResult({ status: "success", user })
Рендер 2: status = "success"  → экран: «Анна»

Между запуском и ответом React продолжает работать: пользователь может кликать, печатать, уходить со страницы. Поэтому код должен учитывать, что к моменту ответа ситуация могла измениться.

Где запускать асинхронную операцию

СитуацияГдеПример
Данные нужны, пока компонент на экранеuseEffect (или библиотека)Загрузить профиль по id
Пользователь что-то сделалОбработчик событияСохранить форму, удалить комментарий
Серверный рендер (Next.js App Router)async Server Componentconst user = await db.user.find(...)
Маршрут SPAloader React Router / TanStack RouterДанные до рендера страницы
Кэш, повторы, фоновое обновлениеTanStack Query, SWRuseQuery({ queryKey: ["user", id], ... })

Ручная загрузка в useEffect: полный пример

import { useEffect, useState } from "react";
 
export default function Profile({ id }) {
  const [result, setResult] = useState({ status: "loading" });
 
  useEffect(() => {
    const controller = new AbortController();
    setResult({ status: "loading" });
 
    async function load() {
      try {
        const response = await fetch(`/api/users/${id}`, { signal: controller.signal });
        if (!response.ok) throw new Error(`HTTP ${response.status}`); // fetch сам не бросает на 404/500
        const user = await response.json();
        setResult({ status: "success", user });
      } catch (error) {
        if (error.name === "AbortError") return;                      // запрос отменён — это не ошибка
        setResult({ status: "error", error });
      }
    }
 
    load();
    return () => controller.abort(); // смена id или уход со страницы → отменить старый запрос
  }, [id]);
 
  if (result.status === "loading") return <p role="status">Загрузка…</p>;
  if (result.status === "error") return <p role="alert">Не удалось загрузить профиль</p>;
  return <h2>{result.user.name}</h2>;
}

Гонка запросов: зачем отмена

Пользователь открыл профиль Анны (id=1), сразу переключился на Бориса (id=2)
 
Без отмены:                              С отменой (cleanup → abort):
запрос 1 ──────────────────▶ ответ «Анна» запрос 1 ──✕ отменён
запрос 2 ────▶ ответ «Борис»              запрос 2 ────▶ ответ «Борис»
экран: «Борис» → через секунду «Анна» ✗   экран: «Борис» ✓

Действие пользователя: в обработчике

function DeleteButton({ commentId, onDeleted }) {
  const [pending, setPending] = useState(false);
  const [error, setError] = useState(null);
 
  async function handleClick() {
    setPending(true);
    setError(null);
    try {
      const res = await fetch(`/api/comments/${commentId}`, { method: "DELETE" });
      if (!res.ok) throw new Error("Не удалось удалить");
      onDeleted(commentId);
    } catch (e) {
      setError(e.message);
    } finally {
      setPending(false);
    }
  }
 
  return (
    <>
      <button onClick={handleClick} disabled={pending}>{pending ? "Удаляем…" : "Удалить"}</button>
      {error && <p role="alert">{error}</p>}
    </>
  );
}

Удаление — следствие клика, а не показа компонента, поэтому эффект здесь не нужен. В React 19 то же самое удобно делать через Actions (useActionState, useTransition).

То же с библиотекой

import { useQuery } from "@tanstack/react-query";
 
function Profile({ id }) {
  const { data: user, isPending, error } = useQuery({
    queryKey: ["user", id],
    queryFn: ({ signal }) => fetch(`/api/users/${id}`, { signal }).then((r) => {
      if (!r.ok) throw new Error(`HTTP ${r.status}`);
      return r.json();
    }),
  });
 
  if (isPending) return <p role="status">Загрузка…</p>;
  if (error) return <p role="alert">Не удалось загрузить профиль</p>;
  return <h2>{user.name}</h2>;
}

Кэш, отмена гонок, повторы и фоновое обновление — уже внутри.

Частые ошибки

// ✗ async-компонент на клиенте
export default async function Profile() { … }
 
// ✗ async-функция прямо в useEffect — эффект вернёт Promise вместо cleanup
useEffect(async () => { … }, []);
 
// ✗ Нет проверки response.ok — страница ошибки 500 попадёт в .json() и упадёт непонятно
const data = await fetch(url).then((r) => r.json());
 
// ✗ Запрос в теле компонента — новый запрос на каждый рендер
function List() {
  fetch("/api/items").then(…);
}

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

  • Описывай все состояния: loading, success, error (и empty).
  • Загрузка при показе — эффект с отменой; действие пользователя — обработчик.
  • fetch не бросает на HTTP-ошибки: проверяй response.ok.
  • Устаревший ответ не должен перезаписывать актуальный: AbortController или флаг.
  • В проектах — TanStack Query/SWR, loaders или Server Components вместо ручного кода.

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

  • Запуск → loading → success | error.
  • Смена параметров → cleanup (abort) → новый запрос.
  • Клик → async-обработчик, не эффект.
  • response.ok, AbortError, без async у эффекта и клиентского компонента.

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

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

Поиск

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