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

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.

Pe scurt

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

Greșit
JSX
createRoot(document.body).render(<App />);
Corect
JSX
// 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

Greșit
JSX
const radacina = createRoot(document.body);
Corect
JSX
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

Greșit
JSX
createRoot(document.body).render(<Modal />);
Corect
JSX
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ă tu

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.

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

function App() {
  return <h1>Magazin</h1>;
}

createRoot(document.body).render(<App />);
Indiciu

createRoot(document.getElementById("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.html un <div id="root"></div> și pornește aplicația doar acolo.
  • Nu da lui createRoot elemente 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

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