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

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

Pe scurt

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

Greșit
JSX
import ReactDOM from "react-dom";
ReactDOM.render(<App />, document.getElementById("root"));
Corect
JSX
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

Greșit
JSX
import ReactDOM from "react-dom";
ReactDOM.hydrate(<App />, document.getElementById("root"));
Corect
JSX
import { hydrateRoot } from "react-dom/client";
hydrateRoot(document.getElementById("root"), <App />);

Echivalentul nou pentru hydrate este hydrateRoot, cu argumentele în ordine inversă.

Repară tu

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”.

Codul care dă eroarea
JSX
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.

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 function
  • TypeError: 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 deja createRoot.
  • Când actualizezi React, caută în proiect ReactDOM.render, hydrate și unmountComponentAtNode și înlocuiește-le.
  • Importă din react-dom/client tot 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

← 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.