createRoot и старый render
На этой странице
createRoot создаёт современный клиентский корень React и возвращает объект с render/unmount. Старый ReactDOM.render устарел в React 18 и удалён в React 19.
Вопрос
Как перейти на createRoot и почему он не подходит для гидрации готового HTML?
Основная идея
Корень — точка, в которой React начинает управлять частью DOM. Старый API одновременно принимал компонент и контейнер: ReactDOM.render(<App />, container). Современный API разделяет создание корня и передачу дерева: createRoot(container).render(<App />).
Корень обычно создают один раз при запуске, а не после каждого события. Для дальнейших изменений используют state, props или вызов root.render с новым деревом, если это действительно нужно внешней интеграции. root.unmount() освобождает React-дерево и эффекты, например при удалении виджета со страницы.
Если контейнер уже содержит HTML этого React-приложения с сервера, выбирают hydrateRoot. createRoot предназначен для клиентского создания интерфейса и не сохраняет SSR-разметку как гидратируемое дерево. Перепутанные API лишают приложение корректного продолжения серверного рендера.
Пример
Клиентский вход React 18+; документ содержит <div id="root"></div>, сборщик преобразует JSX.
import { useState } from 'react';
import { createRoot } from 'react-dom/client';
function App() {
const [count, setCount] = useState(0);
return <button onClick={() => setCount(value => value + 1)}>
Кликнули {count} раз
</button>;
}
const container = document.getElementById('root');
if (!container) throw new Error('Не найден контейнер #root');
const root = createRoot(container);
root.render(<App />);
// Когда внешний владелец виджета завершает его работу: root.unmount().HTML должен содержать контейнер root. После render React создаёт кнопку и управляет её обновлениями. Проверка контейнера даёт понятную ошибку, если вход подключён к неправильной странице.
Было и стало
// React 17 (удалено в React 19)
import ReactDOM from "react-dom";
ReactDOM.render(<App />, document.getElementById("root"));
ReactDOM.hydrate(<App />, document.getElementById("root"));
ReactDOM.unmountComponentAtNode(container);
// React 18+
import { createRoot, hydrateRoot } from "react-dom/client";
const root = createRoot(document.getElementById("root"));
root.render(<App />);
hydrateRoot(document.getElementById("root"), <App />); // для HTML, отрендеренного на сервере
root.unmount();ReactDOM.render | createRoot | hydrateRoot | |
|---|---|---|---|
| Контейнер | Пустой | Пустой (содержимое будет заменено) | С HTML от сервера |
| Concurrent-возможности | Нет | Да | Да |
| Автоматический batching вне событий | Нет | Да | Да |
Опции ошибок (onCaughtError и др.) | Нет | Да (React 19) | Да |
| Статус | Удалён в React 19 | Основной способ | Для SSR |
Несколько корней на странице
// Встраивание React-виджетов в существующий сайт (например, в CMS)
document.querySelectorAll("[data-react-widget='rating']").forEach((el) => {
createRoot(el).render(<Rating productId={el.dataset.productId} />);
});У каждого корня своё независимое дерево. Связать их можно через внешний store или порталы из одного корня.
Что важно помнить
- Нельзя передавать JSX вместо DOM-контейнера в
createRoot. - Настройки корня передают в
createRoot(container, options), а не вторым аргументомroot.render. - Фреймворк обычно сам создаёт корень; не добавляйте второй поверх него.
root.renderне обещает, что эффекты уже завершились к следующей строке кода.
Мини-шпаргалка
Пустой клиентский контейнер → createRoot. Серверный HTML → hydrateRoot. Завершение интеграции → root.unmount.