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>.
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(appfață deroot,Rootfață deroot); - ai șters sau redenumit
<div id="root">dinindex.html; - scriptul e încărcat în
<head>fărătype="module"saudefer, deci rulează înainte cabodysă 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
// index.html: <div id="root"></div>
createRoot(document.getElementById("app")).render(<App />);// 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ă #
createRoot(document.querySelector("root")).render(<App />);createRoot(document.querySelector("#root")).render(<App />);querySelector folosește selectori CSS: id-ul se scrie cu #.
3Script rulat înainte de body
<head>
<script src="/src/main.jsx"></script>
</head><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ă 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”.
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.
Reparația
import { createRoot } from "react-dom/client";
function App() {
return <h1 id="titlu">Magazinul meu</h1>;
}
createRoot(document.getElementById("root")).render(<App />);De ce merge
document.getElementById("app") caută un element cu id-ul app. Pagina nu are unul, deci rezultatul este null, iar createRoot(null) aruncă eroarea înainte să apară ceva pe ecran.
Elementul pregătit pentru aplicație are id-ul root. Cu getElementById("root"), createRoot primește un element real, iar render(<App />) pune titlul în el.
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">dinindex.htmldecâ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, cutype="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
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. 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(). Failed to resolve import "./componente/Card" from "src/App.jsx". Does the file exist? Vite nu găsește fișierul pe care îl imporți: calea relativă e greșită (alt folder, ./ lipsă, ../ în plus) sau numele diferă ca litere mari/mici. Verifică unde e fișierul față de cel care îl importă și scrie calea exact, de exemplu import Card from "./Card". Î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.
