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")).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
createRoot(container) îi dă lui React controlul complet asupra elementului primit: React consideră că tot ce e în el îi aparține și îl rescrie la nevoie. Elementul body nu e însă doar al tău: extensiile de browser (traducere, manager de parole, blocare reclame), scripturile de analytics, chat-urile de suport sau Google Tag Manager adaugă acolo propriile elemente.
Când React randează în body, poate șterge aceste elemente, iar ele, la rândul lor, pot muta sau scoate noduri React. Rezultatul: erori ca „Failed to execute 'removeChild' on 'Node'”, elemente care dispar, evenimente care nu mai merg. De aceea React 18 avertizează din start.
Reparația e să ai un container dedicat. Șablonul Vite are deja în index.html un <div id="root"></div>, iar main.jsx face createRoot(document.getElementById("root")). Dacă ai creat pagina de la zero, adaugă tu acest div. Pentru elemente care trebuie să stea direct în body (modale, notificări), folosește createPortal.
De ce apare: cauzele frecvente
1Aplicația pornită în body
createRoot(document.body).render(<App />);// index.html: <body><div id="root"></div></body>
createRoot(document.getElementById("root")).render(<App />);React controlează doar #root; restul body-ului rămâne liber pentru alte scripturi.
2Container creat din JavaScript
const radacina = createRoot(document.body);const container = document.createElement("div");
container.id = "widget";
document.body.appendChild(container);
const radacina = createRoot(container);Pentru un widget inserat pe o pagină străină, creezi propriul container și dai doar lui controlul.
3Modal care trebuie să stea în body
createRoot(document.body).render(<Modal />);import { createPortal } from "react-dom";
function Modal({ children }) {
return createPortal(<div className="modal">{children}</div>, document.body);
}createPortal adaugă modalul în body fără să ia controlul asupra întregului body.
Repară eroarea, direct în pagină
Fișierul de pornire de mai jos randează aplicația direct în document.body, iar React avertizează „createRoot(): Creating roots directly with document.body is discouraged”. Pagina are deja un <div id="root">. Pornește aplicația în el, ca titlul h1 „Magazin” să apară în #root.
import { createRoot } from "react-dom/client";
function App() {
return <h1>Magazin</h1>;
}
createRoot(document.body).render(<App />);Indiciu
createRoot(document.getElementById("root"))
Reparația
import { createRoot } from "react-dom/client";
function App() {
return <h1>Magazin</h1>;
}
createRoot(document.getElementById("root")).render(<App />);De ce merge
createRoot(document.body) îi dădea lui React controlul asupra întregului body, inclusiv asupra containerului #root și a tot ce ar fi adăugat alte scripturi. React a avertizat, iar titlul nu ajungea în #root.
Cu document.getElementById("root"), React controlează doar containerul dedicat aplicației. Restul paginii rămâne liber pentru extensii și scripturi, iar titlul apare exact în #root.
Alte forme ale mesajului
Warning: render(): Rendering components directly into 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 rendering into a container element created for your app.Warning: hydrateRoot(): Creating roots directly with document.body is discouraged, since its children are often manipulated by third-party scripts and browser extensions.NotFoundError: Failed to execute 'removeChild' on 'Node': The node to be removed is not a child of this node.
Cum o eviți pe viitor
- Păstrează în
index.htmlun<div id="root"></div>și pornește aplicația doar acolo. - Nu da lui
createRootelemente pe care le modifică și alte scripturi (body,html). - Pentru modale, meniuri și notificări care trebuie să iasă din container, folosește
createPortal. - Când integrezi un widget React pe un site existent, creează-i un container propriu.
Întrebări frecvente
Aplicația pare să meargă. E grav?
Poate merge mult timp fără probleme. Dar când un utilizator are o extensie care modifică pagina sau adaugi un script de chat, apar erori greu de reprodus. Un div dedicat elimină riscul.
Pot pune id-ul root direct pe body?
<body id="root"> e tot body-ul, deci aceeași problemă. Ai nevoie de un element separat, în interiorul body-ului.
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(). 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(...). Î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.
