...
Eroare React · Regulile hook-urilor

Warning: The final argument passed to useEffect changed size between renders. The order and size of this array must remain constant.

Pe scurt

Lista de dependențe a unui useEffect (sau useMemo, useCallback) are alt număr de elemente de la o randare la alta, de obicei pentru că ai scris [...produse] sau ai construit lista dinamic. Lista trebuie să aibă mereu aceleași elemente: pune [produse] sau o valoare derivată, de exemplu [produse.length].

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

Ce înseamnă

React compară lista de dependențe element cu element, pe poziții: primul cu primul, al doilea cu al doilea. De aceea lista trebuie să aibă aceeași lungime și aceeași ordine la fiecare randare.

Dacă scrii useEffect(fn, [...produse]), lista de dependențe are atâtea elemente câte produse sunt. Când adaugi un produs, lungimea se schimbă, iar React nu mai poate compara corect și te avertizează. Mesajul arată și cele două liste („Previous: [...] Incoming: [...]”).

Același lucru apare la useMemo, useCallback și useLayoutEffect (numele hook-ului apare în mesaj). Soluția: pune în listă tabloul însuși ([produse]), o valoare simplă derivată ([produse.length]) sau un text stabil ([ids.join(",")]).

De ce apare: cauzele frecvente

1Tablou întins în dependențe

Greșit
JSX
useEffect(() => {
  document.title = produse.length + " produse";
}, [...produse]);
Corect
JSX
useEffect(() => {
  document.title = produse.length + " produse";
}, [produse]);

Tabloul ca un singur element păstrează lungimea listei; React observă schimbarea prin referința nouă a tabloului.

2Listă construită condiționat

Greșit
JSX
const deps = filtru ? [filtru, pagina] : [pagina];
useEffect(incarca, deps);
Corect
JSX
useEffect(incarca, [filtru, pagina]);

Pune mereu toate valorile; dacă una e undefined într-o randare, e în continuare pe aceeași poziție.

Repară tu

Repară eroarea, direct în pagină

Componenta de mai jos actualizează titlul paginii după numărul de produse din coș, dar la adăugarea unui produs consola arată „The final argument passed to useEffect changed size between renders”. Repar-o ca, după un click pe #adauga, titlul paginii să fie „3 produse în coș”, fără avertisment.

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

export default function App() {
  const [cos, setCos] = useState(["Cană", "Bol"]);

  useEffect(() => {
    document.title = cos.length + " produse în coș";
  }, [...cos]);

  return (
    <div>
      <p id="numar">{cos.length}</p>
      <button id="adauga" onClick={() => setCos([...cos, "Pahar"])}>Adaugă</button>
    </div>
  );
}
Indiciu

Pune tabloul întreg în dependențe, nu elementele lui.

Alte forme ale mesajului

  • Warning: The final argument passed to useMemo changed size between renders. The order and size of this array must remain constant.
  • Warning: The final argument passed to useCallback changed size between renders. The order and size of this array must remain constant.
  • React Hook useEffect has a spread element in its dependency array. This means we can't statically verify whether you've passed the correct dependencies.

Cum o eviți pe viitor

  • Scrie lista de dependențe ca o listă fixă de nume: [a, b, c], fără ..., fără if.
  • Pentru tablouri și obiecte pune variabila întreagă sau o valoare simplă derivată din ea.
  • Activează regula ESLint react-hooks/exhaustive-deps: semnalează listele cu spread înainte să rulezi codul.

Întrebări frecvente

De ce cu [...produse] efectul pare să meargă?

Cât timp lungimea nu se schimbă, React compară elementele unul câte unul. Când adaugi sau ștergi un produs, comparația devine greșită și React nu mai garantează că efectul rulează corect.

Vreau ca efectul să ruleze doar când se schimbă conținutul, nu referința. Ce fac?

Folosește o valoare simplă care descrie conținutul: produse.length, un id, sau JSON.stringify(produse) pentru liste mici.

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.