React Hook useEffect has a complex expression in the dependency array. Extract it to a separate variable so it can be statically checked.
În lista de dependențe ai pus o expresie (un apel, un calcul, JSON.stringify, un ternar), nu o simplă variabilă. ESLint nu poate verifica dacă dependențele sunt complete. Calculează valoarea într-o variabilă înaintea efectului și pune variabila în listă: const termen = cautare.trim(); ... [termen].
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Regula react-hooks/exhaustive-deps compară ce valori folosește efectul cu ce ai pus în lista de dependențe. Ca să poată face asta, fiecare element din listă trebuie să fie un nume simplu (id) sau o cale de proprietăți (produs.id, filtre.categorie). Când găsește o expresie complexă, cum ar fi cautare.trim().toLowerCase(), JSON.stringify(filtre), produse.length > 0 sau a + b, nu mai poate verifica nimic și raportează această eroare.
Codul de obicei funcționează, pentru că React doar compară rezultatele expresiilor între randări. Problema e că pierzi verificarea automată: ESLint nu-ți mai poate spune dacă ai uitat o dependență.
Reparația e simplă: calculează expresia înainte de efect, într-o variabilă cu nume, și folosește variabila atât în efect, cât și în listă. Un bonus: numele variabilei explică ce valoare declanșează efectul.
De ce apare: cauzele frecvente
1Apel de metodă în listă
useEffect(() => {
cauta(cautare.trim().toLowerCase());
}, [cautare.trim().toLowerCase()]);const termen = cautare.trim().toLowerCase();
useEffect(() => {
cauta(termen);
}, [termen]);Variabila termen este o dependență simplă, pe care ESLint o poate compara cu ce folosește efectul.
2JSON.stringify pentru un obiect
useEffect(() => {
incarca(filtre);
}, [JSON.stringify(filtre)]);useEffect(() => {
incarca({ categorie: filtre.categorie, max: filtre.max });
}, [filtre.categorie, filtre.max]);Câmpurile obiectului sunt valori simple, iar efectul rulează doar când se schimbă unul dintre ele.
3Condiție calculată în listă
useEffect(() => {
if (cos.length > 0) salveaza(cos);
}, [cos.length > 0]);const areProduse = cos.length > 0;
useEffect(() => {
if (areProduse) salveaza(cos);
}, [areProduse, cos]);Cu variabile separate, ESLint vede că efectul folosește și cos, nu doar condiția.
Repară eroarea, direct în pagină
Căutarea de mai jos filtrează produsele într-un efect, dar ESLint spune „React Hook useEffect has a complex expression in the dependency array”. Mută expresia într-o variabilă termen, folosită în efect și în dependențe, ca după ce scrii „ CANĂ ” în #cautare să rămână un singur produs, „Cană albă”.
import { useState, useEffect } from "react";
const TOATE = ["Cană albă", "Ceainic", "Farfurie"];
export default function App() {
const [cautare, setCautare] = useState("");
const [rezultate, setRezultate] = useState(TOATE);
useEffect(() => {
const t = cautare.trim().toLowerCase();
setRezultate(TOATE.filter((p) => p.toLowerCase().includes(t)));
}, [cautare.trim().toLowerCase()]);
return (
<div>
<input id="cautare" value={cautare} onChange={(e) => setCautare(e.target.value)} />
<ul>
{rezultate.map((p) => <li key={p}>{p}</li>)}
</ul>
</div>
);
}Indiciu
const termen = cautare.trim().toLowerCase(); apoi [termen].
Reparația
import { useState, useEffect } from "react";
const TOATE = ["Cană albă", "Ceainic", "Farfurie"];
export default function App() {
const [cautare, setCautare] = useState("");
const [rezultate, setRezultate] = useState(TOATE);
const termen = cautare.trim().toLowerCase();
useEffect(() => {
setRezultate(TOATE.filter((p) => p.toLowerCase().includes(termen)));
}, [termen]);
return (
<div>
<input id="cautare" value={cautare} onChange={(e) => setCautare(e.target.value)} />
<ul>
{rezultate.map((p) => <li key={p}>{p}</li>)}
</ul>
</div>
);
}De ce merge
cautare.trim().toLowerCase() în lista de dependențe e o expresie, nu o variabilă. React o putea compara, dar ESLint nu mai putea verifica dacă lista e completă.
Calculată o dată, în termen, valoarea e folosită de efect și pusă în listă ca nume simplu. Efectul rulează doar când se schimbă termenul curățat (spațiile și literele mari nu mai contează), iar ESLint poate verifica din nou dependențele.
Alte forme ale mesajului
React Hook useEffect has a complex expression in the dependency array. Extract it to a separate variable so it can be statically checked. react-hooks/exhaustive-depsReact Hook useMemo has a complex expression in the dependency array. Extract it to a separate variable so it can be statically checked.React Hook useCallback has a complex expression in the dependency array. Extract it to a separate variable so it can be statically checked.
Cum o eviți pe viitor
- În lista de dependențe scrie doar nume de variabile sau proprietăți (
id,produs.id). - Orice calcul folosit de efect (trim, lowercase, condiții) fă-l într-o variabilă cu nume, înainte de efect.
- Pentru obiecte, pune în listă câmpurile folosite, nu obiectul transformat în text.
- Lasă ESLint să-ți completeze lista și verifică-i sugestiile.
Întrebări frecvente
Codul merge. E o eroare reală?
Nu strică aplicația, dar dezactivează verificarea dependențelor pentru acel efect. Dacă mai târziu folosești o valoare nouă în efect, ESLint nu te mai poate avertiza că lipsește din listă.
Pot pune produs?.id în dependențe?
Da. Căile cu optional chaining (produs?.id) sunt acceptate de regulă ca dependențe simple.
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]). The 'filtru' object makes the dependencies of useEffect Hook (at line 12) change on every render. To fix this, wrap the initialization of 'filtru' in its own useMemo() Hook. Un obiect, tablou sau funcție creat în corpul componentei e în lista de dependențe a lui useEffect. La fiecare randare e o valoare nouă, deci efectul rulează mereu, iar dacă schimbă starea, apare o buclă. Pune în dependențe valorile simple din care e construit ({ categorie } → [categorie]), mută obiectul în efect sau folosește useMemo. 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]. Î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.
