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 + useState | await в Server Component | |
|---|---|---|---|
| Где работает | Клиент и сервер | Клиент | Сервер |
| Ожидание | Suspense fallback | Свой флаг loading | Стриминг через Suspense |
| Ошибки | Error Boundary | Свой try/catch | error.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 → ближайшее значение. Создание ресурса ≠ чтение ресурса.