Warning: The final argument passed to useEffect changed size between renders. The order and size of this array must remain constant.
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
useEffect(() => {
document.title = produse.length + " produse";
}, [...produse]);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
const deps = filtru ? [filtru, pagina] : [pagina];
useEffect(incarca, deps);useEffect(incarca, [filtru, pagina]);Pune mereu toate valorile; dacă una e undefined într-o randare, e în continuare pe aceeași poziție.
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.
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.
Reparația
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>
);
}De ce merge
Cu [...cos], lista de dependențe avea câte un element pentru fiecare produs: 2 la prima randare, 3 după click. React compară dependențele pe poziții, deci o listă care își schimbă lungimea nu poate fi comparată corect.
[cos] are mereu un singur element. setCos creează un tablou nou, React vede referința nouă, rulează efectul, iar titlul paginii arată numărul actualizat.
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
React Hook useEffect has a missing dependency: 'id'. Either include it or remove the dependency array. Efectul folosește o valoare (prop sau state) care lipsește din lista de dependențe, deci nu rulează din nou când ea se schimbă. Adaug-o în listă: useEffect(() => {...}, [id]). Warning: useEffect received a final argument that is not an array (instead, received `number`). When specified, the final argument must be an array. Al doilea argument al lui useEffect (lista de dependențe) nu e un tablou, de exemplu useEffect(fn, id) în loc de useEffect(fn, [id]). Pune dependențele între paranteze pătrate. La fel la useMemo și useCallback. Warning: Maximum update depth exceeded. This can happen when a component calls setState inside useEffect, but useEffect either doesn't have a dependency array, or one of the dependencies changes on every render. Un useEffect setează state la fiecare randare, iar fiecare setare pornește o randare nouă: efectul n-are listă de dependențe sau depinde de ceva recreat la fiecare randare. Pune dependențele corecte sau calculează valoarea fără efect. Î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.
