Что должен возвращать React-компонент
На этой странице
Компонент возвращает React-узел (ReactNode) — любое значение, которое React умеет отобразить: JSX-элемент, строку или число (как текст), массив узлов (с key), Fragment, портал (createPortal), а также null, undefined, true/false — они ничего не рендерят. Нельзя вернуть обычный объект ({ name: "Анна" }) или функцию — будет ошибка «Objects are not valid as a React child». Один DOM-элемент на компонент не обязателен. Возврат null скрывает вывод, но компонент остаётся смонтированным: его состояние и эффекты продолжают жить. Асинхронными (async) могут быть только Server Components.
Вопрос
Какие значения может вернуть компонент? Чем React-элемент отличается от DOM-узла и что происходит при возврате null?
Что можно вернуть
| Значение | Результат | Пример |
|---|---|---|
| JSX-элемент | Элемент/компонент | return <p>Привет</p> |
| Строка, число | Текстовый узел | return value |
| Массив узлов | Несколько соседей (нужен key) | return [<li key="a"/>, <li key="b"/>] |
| Fragment | Несколько соседей без обёртки | return <><h1/><p/></> |
createPortal(...) | Вывод в другой DOM-узел | Модалки, тосты |
null | Ничего | if (!visible) return null |
undefined, true, false | Ничего | Допустимо с React 18, но undefined чаще означает забытый return |
| Объект данных | ✗ Ошибка | return user |
| Функция | ✗ Предупреждение, ничего | return () => <p/> |
| Promise | ✗ В клиентском компоненте | Только async Server Component |
React-элемент ≠ DOM-узел
function Greeting() {
return <p className="hello">Привет</p>;
}
// Возвращается объект-описание: { type: "p", props: { className: "hello", children: "Привет" } }
// DOM-узел <p> создаст React DOM во время commit.
function Wrong() {
const p = document.createElement("p"); // ✗ настоящий DOM-узел — React не умеет его вставить
return p;
}Пример: разные результаты в одном экране
function Warning({ visible }) {
if (!visible) return null; // ничего
return <p role="alert">Сначала завершите предыдущий урок.</p>;
}
function Score({ value }) {
return value; // число → текст
}
function TopicNames() {
return [ // массив
<li key="react">React</li>,
<li key="ts">TypeScript</li>,
];
}
export default function App() {
return (
<section>
<h1>Результат: <Score value={8} /></h1>
<Warning visible={false} />
<ul><TopicNames /></ul>
</section>
);
}null скрывает, но не размонтирует
function Timer({ visible }) {
const [seconds, setSeconds] = useState(0);
useEffect(() => {
const id = setInterval(() => setSeconds((s) => s + 1), 1000);
return () => clearInterval(id);
}, []);
if (!visible) return null; // таймер продолжает тикать — компонент жив
return <p>{seconds} с</p>;
}<Timer visible={false} /> → компонент смонтирован, эффект работает, state растёт
{visible && <Timer />} → при false компонент размонтирован, state и эффект удаленыВыбирай осознанно: нужен ли компоненту «жизнь» в скрытом состоянии. Для «скрыть, сохранив состояние, но выключив эффекты» в React 19.2 есть <Activity>.
Ошибка «Objects are not valid as a React child»
function UserInfo({ user }) {
return <div>{user}</div>; // ✗ объект
}
function UserInfo({ user }) {
return <div>{user.name}</div>; // ✓ поле
}
function DateLabel({ date }) {
return <time>{date}</time>; // ✗ Date — тоже объект
}
function DateLabel({ date }) {
return <time dateTime={date.toISOString()}>{date.toLocaleDateString("ru-RU")}</time>; // ✓
}async-компоненты
// ✓ Server Component (Next.js App Router и др.): можно await прямо в компоненте
export default async function BookPage({ params }) {
const { slug } = await params;
const book = await db.book.findUnique({ where: { slug } });
return <h1>{book.title}</h1>;
}
// ✗ Клиентский компонент не может быть async
"use client";
export default async function Bad() { /* ошибка */ }
// Для данных на клиенте: use(promise) + Suspense, TanStack Query, loader маршрутаЧто важно помнить
- Компонент возвращает описание (React-узел), а не DOM-узел.
null— явный способ «ничего не показывать»; компонент при этом смонтирован.- Объекты и даты нужно превратить в текст или элементы.
- Массивы требуют
key; соседние элементы удобнее объединять Fragment. async— только у Server Components.
Мини-шпаргалка
- JSX, строка, число, массив, Fragment, портал — отображаются.
null,undefined,true,false— ничего.- Объект, функция, Promise (на клиенте) — ошибка.
return null≠ размонтирование.