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

createRoot(...): Target container is not a DOM element.

Pe scurt

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

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

Ce înseamnă

Fișierul de pornire (main.jsx sau index.js) montează aplicația într-un element din index.html: createRoot(document.getElementById("root")).render(<App />). Dacă getElementById nu găsește elementul, întoarce null, iar createRoot(null) aruncă această eroare. Aplicația nu pornește deloc și pagina rămâne albă.

Cauze frecvente:

  • id-ul din cod diferă de cel din index.html (app față de root, Root față de root);
  • ai șters sau redenumit <div id="root"> din index.html;
  • scriptul e încărcat în <head> fără type="module" sau defer, deci rulează înainte ca body să existe;
  • ai scris document.querySelector("root") (fără #), care caută un tag <root>.

Eroarea din consolă duce direct la linia din fișierul de pornire.

De ce apare: cauzele frecvente

1Id diferit de cel din index.html

Greșit
JSX
// index.html: <div id="root"></div>
createRoot(document.getElementById("app")).render(<App />);
Corect
JSX
// index.html: <div id="root"></div>
createRoot(document.getElementById("root")).render(<App />);

Id-ul trebuie să fie exact cel din index.html, inclusiv literele mari și mici.

2querySelector fără #

Greșit
JSX
createRoot(document.querySelector("root")).render(<App />);
Corect
JSX
createRoot(document.querySelector("#root")).render(<App />);

querySelector folosește selectori CSS: id-ul se scrie cu #.

3Script rulat înainte de body

Greșit
JSX
<head>
  <script src="/src/main.jsx"></script>
</head>
Corect
JSX
<body>
  <div id="root"></div>
  <script type="module" src="/src/main.jsx"></script>
</body>

Scriptul trebuie să ruleze după ce elementul #root există; Vite îl pune la finalul lui body, cu type="module".

Repară tu

Repară eroarea, direct în pagină

Fișierul de mai jos montează singur aplicația, dar dă eroarea „createRoot(...): Target container is not a DOM element”. Pagina noastră, ca orice proiect Vite, are în index.html elementul <div id="root"></div>. Repară montarea ca titlul #titlu să afișeze „Magazinul meu”.

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

function App() {
  return <h1 id="titlu">Magazinul meu</h1>;
}

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

Id-ul elementului din index.html este root.

Alte forme ale mesajului

  • Error: createRoot(...): Target container is not a DOM element.
  • Uncaught Error: Target container is not a DOM element.
  • Error: Target container is not a DOM element.

Cum o eviți pe viitor

  • Nu redenumi <div id="root"> din index.html decât împreună cu fișierul de pornire.
  • Copiază id-ul din HTML în cod, nu-l scrie din memorie.
  • Lasă scriptul generat de Vite la finalul lui body, cu type="module".
  • Dacă montezi React doar într-o parte a unei pagini existente, verifică întâi că elementul există.

Întrebări frecvente

„Target container is not a DOM element” fără createRoot în față înseamnă altceva?

Este același mesaj, din versiunile vechi (ReactDOM.render, React 17) sau din build-urile de producție. Cauza e la fel: elementul în care montezi nu a fost găsit.

Unde e index.html într-un proiect Vite?

În rădăcina proiectului, lângă package.json (nu în public și nici în src). Acolo găsești <div id="root"></div>.

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.