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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
React 18 a schimbat felul în care pornește aplicația. Vechiul ReactDOM.render(<App />, container) încă funcționează, dar într-un mod de compatibilitate: aplicația se comportă ca în React 17 (de exemplu fără gruparea automată a actualizărilor de state în setTimeout sau fetch, fără useTransition complet). React te avertizează la fiecare pornire.
Noul API se importă din react-dom/client:
createRoot(container)creează „rădăcina” aplicației;.render(<App />)afișează componenta în ea.
Avertismentul apare de obicei în proiecte vechi actualizate la React 18 sau când urmezi un tutorial mai vechi. În React 19, ReactDOM.render a fost eliminat complet, deci codul vechi nu mai pornește deloc.
De ce apare: cauzele frecvente
1Pornire cu API-ul din React 17
import ReactDOM from "react-dom";
ReactDOM.render(<App />, document.getElementById("root"));import { createRoot } from "react-dom/client";
createRoot(document.getElementById("root")).render(<App />);createRoot activează modul React 18 pentru toată aplicația.
2hydrate pentru HTML randat pe server
import ReactDOM from "react-dom";
ReactDOM.hydrate(<App />, document.getElementById("root"));import { hydrateRoot } from "react-dom/client";
hydrateRoot(document.getElementById("root"), <App />);Echivalentul nou pentru hydrate este hydrateRoot, cu argumentele în ordine inversă.
Repară eroarea, direct în pagină
Fișierul de mai jos pornește aplicația cu ReactDOM.render, iar consola arată „ReactDOM.render is no longer supported in React 18”. Rescrie pornirea cu createRoot din react-dom/client, în elementul #root, astfel încât să apară titlul #titlu cu textul „Bine ai venit”.
import ReactDOM from "react-dom";
function App() {
return <h1 id="titlu">Bine ai venit</h1>;
}
ReactDOM.render(<App />, document.getElementById("root"));Indiciu
createRoot(container).render(<App />), importat din react-dom/client.
Reparația
import { createRoot } from "react-dom/client";
function App() {
return <h1 id="titlu">Bine ai venit</h1>;
}
createRoot(document.getElementById("root")).render(<App />);De ce merge
ReactDOM.render este API-ul de pornire din React 17. În React 18 el pornește aplicația într-un mod de compatibilitate și afișează avertismentul, iar în React 19 nu mai există.
createRoot creează o rădăcină React 18 în elementul #root, iar .render(<App />) afișează componenta. Restul aplicației rămâne la fel; se schimbă doar cele două linii de pornire.
Alte forme ale mesajului
Warning: ReactDOM.hydrate is no longer supported in React 18. Use hydrateRoot instead. Until you switch to the new API, your app will behave as if it's running React 17.Warning: unmountComponentAtNode is deprecated and will be removed in the next major release. Switch to the createRoot API.TypeError: ReactDOM.render is not a functionTypeError: react_dom__WEBPACK_IMPORTED_MODULE_1__.render is not a function
Cum o eviți pe viitor
- La un proiect nou, folosește un șablon actual (
npm create vite@latest): are dejacreateRoot. - Când actualizezi React, caută în proiect
ReactDOM.render,hydrateșiunmountComponentAtNodeși înlocuiește-le. - Importă din
react-dom/clienttot ce ține de pornirea aplicației (createRoot,hydrateRoot).
Întrebări frecvente
Ce pierd dacă las ReactDOM.render?
Funcțiile React 18 care depind de noul mod: gruparea automată a actualizărilor peste tot, useTransition și useDeferredValue complete, randarea concurentă. Iar în React 19 aplicația nu mai pornește.
„ReactDOM.render is not a function” e aceeași problemă?
E pasul următor: în React 19 funcția nu mai există, deci apelul ei aruncă eroare. Reparația este aceeași, createRoot.
Erori înrudite
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: You are calling ReactDOMClient.createRoot() on a container that has already been passed to createRoot() before. Instead, call root.render() on the existing root instead if you want to update it. Apelezi createRoot de două ori pe același element, de obicei pentru că fișierul de pornire montează aplicația de două ori sau creezi rădăcina în interiorul unei funcții apelate repetat. Creează rădăcina o singură dată, păstreaz-o într-o variabilă și apelează doar root.render(). Invalid hook call. Hooks can only be called inside of the body of a function component. Ai apelat un hook (useState, useEffect, useContext...) în afara corpului unei componente funcție: într-un handler, într-o funcție obișnuită sau într-o clasă. Mută apelul la începutul componentei. Î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.
