...
Eroare React · State, props și re-randări

Do not define components during render. React will see a new component type on every render and destroy the entire subtree’s DOM nodes and state.

Pe scurt

Ai definit o componentă în interiorul altei componente. La fiecare randare a părintelui ea devine o funcție nouă, iar React o demontează și o montează din nou: starea ei se resetează, iar inputurile pierd focusul după fiecare literă. Mută definiția în afara părintelui și trimite datele prin props.

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

Ce înseamnă

Mesajul vine de la ESLint, regula react/no-unstable-nested-components, dar descrie un comportament real al lui React.

React compară, la fiecare randare, tipul fiecărui element. Când scrii function Camp() {...} în corpul lui App, la fiecare randare a lui App se creează o funcție Camp nouă. Pentru React, <Camp /> de acum este alt tip decât <Camp /> de dinainte, așa că:

  • demontează vechea componentă, cu tot cu starea și nodurile DOM;
  • montează una nouă, cu starea inițială.

Simptome tipice: un input pierde focusul după fiecare literă scrisă, un contor din copil revine la 0 când se schimbă ceva în părinte, efectele copilului rulează din nou la fiecare randare.

Reparația: definește componenta la nivelul fișierului (sau în alt fișier) și dă-i prin props ce folosea din părinte. Dacă vrei doar să împarți JSX-ul, poți apela o funcție simplă ({randeazaAntet()}), care nu e tratată ca o componentă separată.

De ce apare: cauzele frecvente

1Componentă cu stare definită în părinte

Greșit
JSX
function App() {
  const [tema, setTema] = useState("luminoasa");
  function Contor() {
    const [n, setN] = useState(0);
    return <button onClick={() => setN(n + 1)}>{n}</button>;
  }
  return <Contor />;
}
Corect
JSX
function Contor() {
  const [n, setN] = useState(0);
  return <button onClick={() => setN(n + 1)}>{n}</button>;
}
function App() {
  const [tema, setTema] = useState("luminoasa");
  return <Contor />;
}

Definit afară, Contor este aceeași funcție la fiecare randare, deci React îi păstrează starea.

2Input care pierde focusul

Greșit
JSX
function Formular() {
  const [nume, setNume] = useState("");
  const Camp = () => <input value={nume} onChange={(e) => setNume(e.target.value)} />;
  return <Camp />;
}
Corect
JSX
function Camp({ value, onChange }) {
  return <input value={value} onChange={onChange} />;
}
function Formular() {
  const [nume, setNume] = useState("");
  return <Camp value={nume} onChange={(e) => setNume(e.target.value)} />;
}

Fiecare literă schimbă starea, Camp devine o componentă nouă și React înlocuiește inputul, care pierde focusul.

3Componentă definită în props

Greșit
JSX
<Tabel randeazaRand={(r) => {
  function Rand() { return <tr><td>{r.nume}</td></tr>; }
  return <Rand />;
}} />
Corect
JSX
function Rand({ r }) {
  return <tr><td>{r.nume}</td></tr>;
}
<Tabel randeazaRand={(r) => <Rand r={r} />} />

Funcția din props creează la fiecare apel o componentă nouă; cu Rand definit o dată, tipul rămâne stabil.

Repară tu

Repară eroarea, direct în pagină

În componenta de mai jos, Contor este definit în interiorul lui App (ESLint: „Do not define components during render”). Dacă apeși de două ori pe #plus și apoi pe #tema, contorul revine la 0. Repar-o ca, după aceste trei click-uri, #plus să arate 2, iar #tema „Temă: întunecată”.

Codul care dă eroarea
JSX
import { useState } from "react";

export default function App() {
  const [intunecata, setIntunecata] = useState(false);

  function Contor() {
    const [n, setN] = useState(0);
    return <button id="plus" onClick={() => setN(n + 1)}>{n}</button>;
  }

  return (
    <div>
      <Contor />
      <button id="tema" onClick={() => setIntunecata(!intunecata)}>
        Temă: {intunecata ? "întunecată" : "luminoasă"}
      </button>
    </div>
  );
}
Indiciu

Mută funcția Contor deasupra lui App.

Alte forme ale mesajului

  • Do not define components during render. React will see a new component type on every render and destroy the entire subtree’s DOM nodes and state (https://reactjs.org/docs/reconciliation.html#elements-of-different-types). Instead, move this component definition out of the parent component “App” and pass data as props. react/no-unstable-nested-components
  • Do not define components during render. React will see a new component type on every render and destroy the entire subtree’s DOM nodes and state. Instead, move this component definition out of the parent component “Formular” and pass data as props. If you want to allow component creation in props, set allowAsProps option to true.

Cum o eviți pe viitor

  • Definește fiecare componentă la nivelul fișierului, niciodată în corpul altei componente.
  • Trimite prin props tot ce folosea componenta din părinte (valori și funcții).
  • Când vrei doar să împarți un JSX lung, folosește o funcție obișnuită apelată cu {randeaza()} sau o variabilă.
  • Dacă un input pierde focusul după fiecare literă, caută întâi o componentă definită în interiorul alteia.

Întrebări frecvente

Codul merge, de ce ar fi o problemă?

Merge cât timp componenta interioară nu are stare, focus sau efecte. Chiar și atunci, React recreează tot DOM-ul ei la fiecare randare, ceea ce e mai lent. La primul useState sau input, apar bug-uri greu de înțeles.

Ajută dacă pun componenta interioară în useCallback?

Tehnic ar păstra aceeași funcție, dar e un ocoliș fragil. Soluția simplă și clară este să muți componenta afară și să-i dai datele prin props.

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.