Работа с асинхронными операциями
На этой странице
Асинхронная операция (запрос к 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 Component | const user = await db.user.find(...) |
| Маршрут SPA | loader React Router / TanStack Router | Данные до рендера страницы |
| Кэш, повторы, фоновое обновление | TanStack Query, SWR | useQuery({ 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у эффекта и клиентского компонента.