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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
useEffect(efect, dependente) așteaptă ca al doilea argument să fie un tablou: [] pentru „doar la montare”, [id] pentru „când se schimbă id”. Dacă îi dai direct o valoare (id, "text", un obiect), React nu o poate compara între randări și te avertizează. Tipul primit apare în mesaj (number, string, object).
Efectul se comportă atunci imprevizibil: de obicei rulează după fiecare randare, ca și cum n-ai fi dat dependențe, deci poate trimite cereri fetch de prea multe ori.
Greșeala apare când scrii repede useEffect(fn, id), când treci un obiect de opțiuni (useEffect(fn, { id })) sau la useMemo(() => calc(), cos). Repararea e mereu aceeași: paranteze pătrate.
De ce apare: cauzele frecvente
1Dependența scrisă fără paranteze
useEffect(() => {
incarcaProdus(id);
}, id);useEffect(() => {
incarcaProdus(id);
}, [id]);Lista de dependențe este întotdeauna un tablou, chiar dacă are un singur element.
2Obiect în loc de tablou
useEffect(() => {
cauta(text, pagina);
}, { text, pagina });useEffect(() => {
cauta(text, pagina);
}, [text, pagina]);React compară dependențele pe poziții, deci are nevoie de un tablou, nu de un obiect.
3Aceeași greșeală la useMemo
const total = useMemo(() => calculeaza(cos), cos);const total = useMemo(() => calculeaza(cos), [cos]);useMemo și useCallback folosesc aceeași regulă pentru lista de dependențe.
Repară eroarea, direct în pagină
Componenta de mai jos încarcă detaliile unui produs după id, dar consola arată „useEffect received a final argument that is not an array”. Repar-o ca la început #nume să afișeze „Laptop”, iar după click pe #urmator să afișeze „Mouse”.
import { useState, useEffect } from "react";
export default function App() {
const [id, setId] = useState(1);
const [produs, setProdus] = useState(null);
useEffect(() => {
fetch("https://api.exemplu.ro/produse/" + id)
.then((r) => r.json())
.then((date) => setProdus(date));
}, id);
return (
<div>
<h2 id="nume">{produs ? produs.nume : "Se încarcă..."}</h2>
<button id="urmator" onClick={() => setId(2)}>Următorul</button>
</div>
);
}Indiciu
Lista de dependențe se scrie între paranteze pătrate.
Reparația
import { useState, useEffect } from "react";
export default function App() {
const [id, setId] = useState(1);
const [produs, setProdus] = useState(null);
useEffect(() => {
fetch("https://api.exemplu.ro/produse/" + id)
.then((r) => r.json())
.then((date) => setProdus(date));
}, [id]);
return (
<div>
<h2 id="nume">{produs ? produs.nume : "Se încarcă..."}</h2>
<button id="urmator" onClick={() => setId(2)}>Următorul</button>
</div>
);
}De ce merge
Al doilea argument al lui useEffect trebuie să fie un tablou, pentru că React compară dependențele element cu element între randări. Un număr simplu nu poate fi comparat așa, deci React avertizează și tratează efectul ca fără dependențe.
Cu [id], efectul rulează la montare (pentru id 1) și apoi doar când id se schimbă. Click-ul pe „Următorul” schimbă id în 2, efectul cere produsul 2, iar titlul afișează „Mouse”.
Alte forme ale mesajului
Warning: useEffect received a final argument that is not an array (instead, received `string`). When specified, the final argument must be an array.Warning: useMemo received a final argument that is not an array (instead, received `object`). When specified, the final argument must be an array.Warning: useCallback received a final argument that is not an array (instead, received `number`). When specified, the final argument must be an array.
Cum o eviți pe viitor
- Scrie mereu al doilea argument între
[ ]:[],[id],[text, pagina]. - Activează ESLint cu regula
react-hooks/exhaustive-deps: îți propune automat lista corectă. - Dacă vrei ca efectul să ruleze după fiecare randare, omite cu totul al doilea argument, nu pune o valoare simplă.
Întrebări frecvente
Care e diferența între [] și fără argument?
[] înseamnă „o singură dată, după montare”. Fără al doilea argument, efectul rulează după fiecare randare.
De ce aplicația nu crapă, dacă e greșit?
React doar te avertizează și tratează efectul ca fără dependențe. Codul rulează, dar mai des decât vrei, ceea ce poate duce la cereri multiple sau la bucle de actualizări.
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: 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]. 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.
