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

Что должен возвращать 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 ≠ размонтирование.

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

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

Поиск

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