...
Eroare React · Pornirea aplicației, importuri și configurare

Warning: You are importing createRoot from 'react-dom' which is not supported. You should instead import it from 'react-dom/client'.

Pe scurt

În React 18, createRoot și hydrateRoot se importă din 'react-dom/client', nu din 'react-dom'. Schimbă importul în main.jsx: import { createRoot } from "react-dom/client"; sau import ReactDOM from "react-dom/client"; și ReactDOM.createRoot(...).

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

React 18 a mutat API-ul de pornire a aplicației într-un punct de intrare separat: react-dom/client. Acolo sunt createRoot (pentru aplicațiile randate în browser) și hydrateRoot (pentru HTML venit de pe server). Pachetul react-dom simplu păstrează utilitare ca createPortal și flushSync.

În React 18, createRoot încă există și în react-dom, ca să nu strice codul imediat, dar afișează acest avertisment. În React 19 a fost scos de acolo, deci import { createRoot } from "react-dom" dă eroare la pornire.

Greșeala apare de obicei în main.jsx / index.js, scris din memorie sau copiat dintr-un exemplu vechi. Variante corecte:

  • import { createRoot } from "react-dom/client"; apoi createRoot(...);
  • import ReactDOM from "react-dom/client"; apoi ReactDOM.createRoot(...).

Același avertisment există pentru hydrateRoot. Dacă vezi „ReactDOM.render is no longer supported in React 18”, e problema înrudită: API-ul vechi de pornire, nu doar importul.

De ce apare: cauzele frecvente

1Import din pachetul greșit

Greșit
JSX
import { createRoot } from "react-dom";

createRoot(document.getElementById("root")).render(<App />);
Corect
JSX
import { createRoot } from "react-dom/client";

createRoot(document.getElementById("root")).render(<App />);

react-dom/client este locul oficial al lui createRoot din React 18.

2ReactDOM importat din react-dom

Greșit
JSX
import ReactDOM from "react-dom";

ReactDOM.createRoot(document.getElementById("root")).render(<App />);
Corect
JSX
import ReactDOM from "react-dom/client";

ReactDOM.createRoot(document.getElementById("root")).render(<App />);

Obiectul ReactDOM din react-dom/client conține createRoot și hydrateRoot.

3hydrateRoot pentru SSR

Greșit
JSX
import { hydrateRoot } from "react-dom";
Corect
JSX
import { hydrateRoot } from "react-dom/client";

Ambele funcții de pornire stau în react-dom/client.

Repară tu

Repară eroarea, direct în pagină

Fișierul de pornire de mai jos importă createRoot din react-dom, iar React 18 avertizează „You are importing createRoot from 'react-dom' which is not supported”. Repară importul, ca aplicația să pornească în #root și să afișeze titlul h1 „Magazin”.

Codul care dă eroarea
JSX
import { createRoot } from "react-dom";

function App() {
  return <h1>Magazin</h1>;
}

createRoot(document.getElementById("root")).render(<App />);
Indiciu

import { createRoot } from "react-dom/client";

Alte forme ale mesajului

  • Warning: You are importing hydrateRoot from 'react-dom' which is not supported. You should instead import it from 'react-dom/client'.
  • TypeError: (0 , react_dom__WEBPACK_IMPORTED_MODULE_1__.createRoot) is not a function
  • SyntaxError: The requested module '/node_modules/.vite/deps/react-dom.js' does not provide an export named 'createRoot'
  • TypeError: ReactDOM.createRoot is not a function

Cum o eviți pe viitor

  • Scrie main.jsx după șablonul oficial: import { createRoot } from "react-dom/client".
  • Nu copia codul de pornire din tutoriale vechi (React 17 sau mai vechi).
  • După actualizarea React, verifică fișierul de pornire și consola.
  • Folosește npm create vite@latest, care generează importurile corecte.

Întrebări frecvente

Primesc „ReactDOM.createRoot is not a function”. E aceeași problemă?

Aproape. Fie importi ReactDOM din react-dom într-o versiune unde nu mai există (React 19), fie proiectul are React 17, unde createRoot nu exista. Verifică versiunea în package.json și importă din react-dom/client.

Ce mai import din react-dom, simplu?

Funcții ca createPortal (pentru modale randate în altă parte a paginii) și flushSync. Pornirea aplicației se face doar din react-dom/client.

Erori înrudite

← Toate erorile React

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață React de la zero, cu exerciții la fiecare lecție

Curs React: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.