Warning: You are importing createRoot from 'react-dom' which is not supported. You should instead import it from 'react-dom/client'.
Î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";apoicreateRoot(...);import ReactDOM from "react-dom/client";apoiReactDOM.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
import { createRoot } from "react-dom";
createRoot(document.getElementById("root")).render(<App />);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
import ReactDOM from "react-dom";
ReactDOM.createRoot(document.getElementById("root")).render(<App />);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
import { hydrateRoot } from "react-dom";import { hydrateRoot } from "react-dom/client";Ambele funcții de pornire stau în react-dom/client.
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”.
import { createRoot } from "react-dom";
function App() {
return <h1>Magazin</h1>;
}
createRoot(document.getElementById("root")).render(<App />);Indiciu
import { createRoot } from "react-dom/client";
Reparația
import { createRoot } from "react-dom/client";
function App() {
return <h1>Magazin</h1>;
}
createRoot(document.getElementById("root")).render(<App />);De ce merge
Din React 18, createRoot aparține punctului de intrare react-dom/client. Importul din react-dom mai funcționa doar ca o compatibilitate temporară, cu avertisment, și nu mai există deloc în React 19.
Cu importul din react-dom/client, aplicația pornește la fel, dar fără avertisment și compatibil cu versiunile următoare. createRoot primește elementul #root, iar render afișează App în el.
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 functionSyntaxError: 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.jsxdupă ș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
Warning: ReactDOM.render is no longer supported in React 18. Use createRoot instead. Until you switch to the new API, your app will behave as if it's running React 17. Learn more: https://reactjs.org/link/switch-to-createroot Pornești aplicația cu ReactDOM.render, API-ul din React 17. În React 18 se folosește createRoot din "react-dom/client": createRoot(document.getElementById("root")).render(<App />). Până schimbi, aplicația rulează ca în React 17, fără funcțiile noi. createRoot(...): Target container is not a DOM element. createRoot a primit null în loc de un element: document.getElementById caută un id care nu există în index.html (de exemplu "app" în loc de "root"), sau scriptul rulează înainte să existe elementul. Folosește exact id-ul din index.html: <div id="root"></div>. Warning: createRoot(): Creating roots directly with document.body is discouraged, since its children are often manipulated by third-party scripts and browser extensions. This may lead to subtle reconciliation issues. Try using a container element created for your app. Ai pornit aplicația cu createRoot(document.body). Extensiile de browser și scripturile externe (analytics, chat) adaugă și scot elemente din body, iar React se încurcă. Pune în index.html un <div id="root"></div> și pornește aplicația în el: createRoot(document.getElementById("root")). Î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.
