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

Data Router: loader, action и ленивые маршруты

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

Data mode React Router (v6.4+, v7) объединяет маршрутизацию и данные: маршруты описываются конфигом в createBrowserRouter, у маршрута есть loader (загрузка данных до рендера, параллельно для всех вложенных маршрутов), action (обработка отправки <Form> и мутаций), errorElement/ErrorBoundary (ошибки загрузки и рендера) и lazy (код маршрута загружается параллельно с данными). После action React Router автоматически перевыполняет loaders — данные на экране обновляются без ручной синхронизации. Это устраняет главные проблемы подхода «fetch в useEffect»: водопады запросов, ручные флаги загрузки, гонки и рассинхронизацию после мутаций. Состояние навигации даёт useNavigation, неблокирующие мутации — useFetcher. Framework mode (бывший Remix) добавляет к этому SSR, prerender и типизацию.

Вопрос

Что такое loaders и actions в React Router? Чем data router лучше загрузки данных в useEffect?

Сравнение подходов

Declarative + useEffect:
  клик → смена URL → рендер страницы → useEffect → fetch → рендер дочернего → его fetch ...
  (водопад, спиннеры на каждом уровне)
 
Data Router:
  клик → React Router параллельно запускает: код маршрута (lazy) + loaders всех вложенных маршрутов
       → когда готово — рендер готовых данных

Конфигурация

// main.tsx
import { createBrowserRouter, RouterProvider } from 'react-router';
import { createRoot } from 'react-dom/client';
import Root from './routes/root';
import ErrorPage from './routes/error-page';
 
const router = createBrowserRouter([
  {
    path: '/',
    Component: Root,
    ErrorBoundary: ErrorPage,
    children: [
      { index: true, lazy: () => import('./routes/home') },
      {
        path: 'books',
        lazy: () => import('./routes/books'),       // экспортирует loader и Component
        children: [
          { path: ':bookId', lazy: () => import('./routes/book') },
        ],
      },
    ],
  },
]);
 
createRoot(document.getElementById('root')!).render(<RouterProvider router={router} />);

loader: данные до рендера

// routes/book.tsx
import { useLoaderData, data, type LoaderFunctionArgs } from 'react-router';
 
export async function loader({ params, request }: LoaderFunctionArgs) {
  const res = await fetch(`/api/books/${params.bookId}`, { signal: request.signal }); // отмена при уходе
  if (res.status === 404) throw data('Книга не найдена', { status: 404 });
  return res.json() as Promise<Book>;
}
 
export function Component() {
  const book = useLoaderData<typeof loader>();
  return (
    <article>
      <h1>{book.title}</h1>
      <p>{book.description}</p>
    </article>
  );
}
  • request.signal отменяет запрос, если пользователь ушёл на другую страницу, — гонок нет.
  • Брошенный data(..., { status }) или ошибка попадает в ближайший ErrorBoundary.
  • Loaders вложенных маршрутов (books и :bookId) выполняются параллельно.

action: мутации через Form

// routes/book.tsx (продолжение)
import { Form, redirect, useNavigation, type ActionFunctionArgs } from 'react-router';
 
export async function action({ request, params }: ActionFunctionArgs) {
  const formData = await request.formData();
  const rating = Number(formData.get('rating'));
  if (rating < 1 || rating > 5) return { error: 'Оценка от 1 до 5' };
 
  await fetch(`/api/books/${params.bookId}/rating`, {
    method: 'POST',
    body: JSON.stringify({ rating }),
    headers: { 'Content-Type': 'application/json' },
  });
  return redirect(`/books/${params.bookId}`); // после action loaders перевыполнятся
}
 
function RatingForm() {
  const navigation = useNavigation();
  const busy = navigation.state === 'submitting';
  return (
    <Form method="post">
      <label>Оценка <input name="rating" type="number" min={1} max={5} /></label>
      <button disabled={busy}>{busy ? 'Сохраняем…' : 'Оценить'}</button>
    </Form>
  );
}

<Form> работает как HTML-форма, но без перезагрузки: React Router вызывает action, затем обновляет данные всех активных маршрутов. Результат action (ошибки валидации) читается через useActionData().

useFetcher: мутации без навигации

function FavoriteButton({ book }: { book: Book }) {
  const fetcher = useFetcher();
  const isFavorite = fetcher.formData ? fetcher.formData.get('favorite') === 'true' : book.favorite; // оптимистично
 
  return (
    <fetcher.Form method="post" action={`/books/${book.id}/favorite`}>
      <button name="favorite" value={String(!isFavorite)} aria-pressed={isFavorite}>
        {isFavorite ? '★' : '☆'}
      </button>
    </fetcher.Form>
  );
}

Подходит для лайков, избранного, отметок в списке — URL не меняется, несколько fetcher-ов работают параллельно.

Глобальный индикатор и ошибки

export default function Root() {
  const navigation = useNavigation();
  return (
    <>
      {navigation.state === 'loading' && <div className="progress-bar" role="progressbar" aria-label="Загрузка страницы" />}
      <Outlet />
    </>
  );
}
 
export function ErrorPage() {
  const error = useRouteError();
  if (isRouteErrorResponse(error)) return <h1>{error.status}: {error.data}</h1>;
  return <h1>Что-то пошло не так</h1>;
}

Режимы React Router 7

РежимЧто естьКогда
Declarative<BrowserRouter>, <Routes>, <Route>Простое SPA, миграция со старых версий
DatacreateBrowserRouter, loaders, actions, fetchers, lazySPA с серьёзной работой с данными
FrameworkVite-плагин, файловые маршруты, SSR/prerender, типы Route.*Полноценное приложение, SEO, альтернатива Next.js

Связка с TanStack Query

export const loader = (queryClient: QueryClient) => async ({ params }: LoaderFunctionArgs) =>
  queryClient.ensureQueryData(bookQuery(params.bookId!)); // берёт из кэша или загружает
 
function Component() {
  const { bookId } = useParams();
  const { data: book } = useSuspenseQuery(bookQuery(bookId!)); // тот же ключ — данные уже есть
}

Loader начинает загрузку как можно раньше, а TanStack Query отвечает за кэш, фоновое обновление и инвалидацию.

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

  • Loader не заменяет кэш: без библиотеки данные загружаются при каждом переходе.
  • lazy + loader = код и данные параллельно, без водопада.
  • После action данные обновляются автоматически — не нужно вручную «перезапрашивать».
  • Проверка прав в loader на клиенте — удобство UX, а не защита: API должен проверять доступ сам.

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

createBrowserRouter([...]) + <RouterProvider>
loader → данные до рендера, параллельно, request.signal
action + <Form> → мутация → автоперезагрузка loaders
useLoaderData, useActionData, useNavigation, useFetcher
ErrorBoundary + useRouteError + isRouteErrorResponse
lazy → код маршрута параллельно с данными

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

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

Поиск

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