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

API use в React 19

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

use читает Promise или Context во время рендера. Для Promise он интегрируется с Suspense и Error Boundary; источник Promise должен быть стабильным.

Вопрос

Как работает use и чем его правила отличаются от правил обычных хуков?

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

use(promise) возвращает разрешённое значение. Пока Promise ожидается, компонент приостанавливается и ближайший Suspense показывает fallback. При отклонении ошибка доходит до Error Boundary. Это чтение существующего ресурса, а не универсальная команда автоматически создать, кешировать и повторять запрос.

Для клиентского компонента особенно важна стабильная ссылка. use(fetch(url).then(...)) создаёт новый Promise при каждой попытке рендера и может постоянно возвращать приложение к ожиданию. Promise передают из Server Component, loader, поддерживаемого кеша или события. Сохранять такой Promise в state допустимо, если его создание не происходит безусловно в render.

use(Context) читает контекст, подобно useContext. В отличие от обычных хуков, use разрешён в условиях и циклах, но только во время выполнения компонента или собственного хука. Вызов use(promise) не оборачивают в try/catch: для обработки ошибки используют границу либо заранее преобразуют Promise.

use против других способов получить данные

use(promise)useEffect + useStateawait в Server Component
Где работаетКлиент и серверКлиентСервер
ОжиданиеSuspense fallbackСвой флаг loadingСтриминг через Suspense
ОшибкиError BoundaryСвой try/catcherror.tsx / Error Boundary
Можно в условииДаНетДа
Создаёт запросНет — только читает готовый промисДаДа
use(Context)useContext(Context)
В условии / после returnМожноНельзя
В циклеМожноНельзя
РезультатБлижайшее значение провайдераТо же

Типичный сценарий: промис с сервера в клиентский компонент

// app/post/[id]/page.tsx — Server Component: запускает запрос, но НЕ ждёт его
import { Suspense } from "react";
import { Comments } from "./comments";
 
export default async function Post({ params }: { params: Promise<{ id: string }> }) {
  const { id } = await params;
  const post = await getPost(id);              // важное — ждём сразу
  const commentsPromise = getComments(id);     // второстепенное — передаём промис
 
  return (
    <article>
      <h1>{post.title}</h1>
      <Suspense fallback={<p>Загружаем комментарии…</p>}>
        <Comments commentsPromise={commentsPromise} />
      </Suspense>
    </article>
  );
}
// comments.tsx
"use client";
import { use } from "react";
 
export function Comments({ commentsPromise }: { commentsPromise: Promise<Comment[]> }) {
  const comments = use(commentsPromise); // стабильный промис: создан на сервере один раз
  return <ul>{comments.map((c) => <li key={c.id}>{c.text}</li>)}</ul>;
}

Статья видна сразу, комментарии стримятся следом, а клиентский компонент получает данные без useEffect.

Пример

Самодостаточный клиентский пример React 19 с фиксированными учебными данными и react-error-boundary.

import { createContext, Suspense, use } from 'react';
import { ErrorBoundary } from 'react-error-boundary';
 
const Theme = createContext('light');
const bookPromise = Promise.resolve({ title: 'React без паники' });
 
function Book({ visible }) {
  if (!visible) return null;
  const theme = use(Theme);
  const book = use(bookPromise);
  return <article className={theme}><h2>{book.title}</h2></article>;
}
export default function App() {
  return <Theme.Provider value="light">
    <ErrorBoundary fallback={<p role="alert">Книга недоступна</p>}>
      <Suspense fallback={<p role="status">Загрузка...</p>}>
        <Book visible />
      </Suspense>
    </ErrorBoundary>
  </Theme.Provider>;
}

Учебный Promise создан один раз на уровне клиентского модуля. Условный ранний return допустим для use, но такое правило нельзя переносить на useState или useEffect.

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

  • Пример требует React 19 и установленного react-error-boundary.
  • Общий модульный Promise с персональными данными нельзя бездумно использовать на сервере между запросами.
  • На сервере в async-компоненте обычно предпочтительнее await.
  • Actions сами не инвалидируют произвольный Promise-кеш: обновление ресурса проектируют отдельно.

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

Promise → use → result/Suspense/Error Boundary. Context → use → ближайшее значение. Создание ресурса ≠ чтение ресурса.

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

Чтение ресурсов через use.

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

Поиск

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