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]).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul nu vine de la React, ci de la ESLint (regula react-hooks/exhaustive-deps), care îl afișează în editor sau în terminalul proiectului (Vite, Create React App, Next.js). Regula citește corpul efectului, vede ce variabile din componentă folosește și compară cu lista de dependențe.
Lista de dependențe îi spune React-ului când să ruleze din nou efectul. Dacă efectul încarcă produsul cu id, dar lista este [], efectul rulează doar la montare: când utilizatorul alege alt produs, id se schimbă, dar datele afișate rămân ale primului produs. Eroarea nu oprește aplicația, dar produce exact astfel de date „vechi”.
Reparația obișnuită este să adaugi valoarea în listă. Dacă asta creează o buclă (de exemplu e un obiect sau o funcție nouă la fiecare randare), mut-o în efect sau stabilizeaz-o cu useCallback / useMemo.
De ce apare: cauzele frecvente
1Fetch care depinde de un prop, cu listă goală
useEffect(() => {
fetch(`/api/produse/${id}`).then((r) => r.json()).then(setProdus);
}, []);useEffect(() => {
fetch(`/api/produse/${id}`).then((r) => r.json()).then(setProdus);
}, [id]);Cu [id] efectul rulează din nou de fiecare dată când se schimbă produsul ales.
2Funcție din componentă folosită în efect
function incarca() { fetch(`/api/comenzi?pagina=${pagina}`)... }
useEffect(() => { incarca(); }, []);useEffect(() => {
function incarca() { fetch(`/api/comenzi?pagina=${pagina}`)... }
incarca();
}, [pagina]);Mutată în efect, funcția nu mai este o dependență; rămâne doar pagina, o valoare simplă.
Repară eroarea, direct în pagină
Componenta Produs încarcă detaliile produsului cu id-ul primit, dar efectul are lista de dependențe goală. Când apeși #urmator, id-ul devine 2, dar #nume rămâne „Laptop”. Repară lista de dependențe ca după click să apară „Mouse”.
import { useState, useEffect } from "react";
function Produs({ id }) {
const [produs, setProdus] = useState(null);
useEffect(() => {
fetch(`https://api.exemplu.ro/produse/${id}`)
.then((r) => r.json())
.then((date) => setProdus(date));
}, []);
if (!produs) return <p>Se încarcă...</p>;
return <h2 id="nume">{produs.nume}</h2>;
}
export default function App() {
const [id, setId] = useState(1);
return (
<div>
<Produs id={id} />
<button id="urmator" onClick={() => setId(2)}>Produsul următor</button>
</div>
);
}Indiciu
Ce valoare folosește efectul și lipsește din listă?
Reparația
import { useState, useEffect } from "react";
function Produs({ id }) {
const [produs, setProdus] = useState(null);
useEffect(() => {
fetch(`https://api.exemplu.ro/produse/${id}`)
.then((r) => r.json())
.then((date) => setProdus(date));
}, [id]);
if (!produs) return <p>Se încarcă...</p>;
return <h2 id="nume">{produs.nume}</h2>;
}
export default function App() {
const [id, setId] = useState(1);
return (
<div>
<Produs id={id} />
<button id="urmator" onClick={() => setId(2)}>Produsul următor</button>
</div>
);
}De ce merge
Lista de dependențe goală înseamnă „rulează efectul doar la montare”. Când id devine 2, componenta se randează din nou cu noul prop, dar efectul nu mai rulează, deci produsul din state rămâne cel cu id 1.
Cu [id], React compară valoarea lui id după fiecare randare: când s-a schimbat, rulează din nou efectul, care face cererea pentru produsul nou. Regula ESLint exhaustive-deps există tocmai ca să prindă dependențele uitate.
Alte forme ale mesajului
React Hook useEffect has missing dependencies: 'id' and 'pagina'. Either include them or remove the dependency array.React Hook useCallback has a missing dependency: 'cos'. Either include it or remove the dependency array.React Hook useEffect has a missing dependency: 'incarca'. Either include it or remove the dependency array. react-hooks/exhaustive-deps
Cum o eviți pe viitor
- Activează
eslint-plugin-react-hooksși nu ignora avertismentul cu un comentariueslint-disable. - Pune în listă tot ce folosește efectul din props, state sau variabile din componentă.
- Ține funcțiile folosite doar de efect în interiorul lui.
- Pentru valorile care nu trebuie să repornească efectul, folosește
useRef.
Întrebări frecvente
De ce nu văd mesajul în consola browserului?
Pentru că vine de la ESLint, nu de la React. Îl vezi în editor (subliniat galben), în terminalul unde rulează npm run dev sau la npm run lint. În editorul din curs vezi doar efectul lui: datele nu se actualizează.
Dacă adaug dependența, efectul intră în buclă. Ce fac?
Dependența se schimbă la fiecare randare: e un obiect, un tablou sau o funcție creată în componentă. Mut-o în efect, folosește doar câmpurile primitive de care ai nevoie sau stabilizeaz-o cu useMemo / useCallback.
Erori înrudite
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. Warning: useEffect must not return anything besides a function, which is used for clean-up. Ai scris useEffect(async () => ...): o funcție async întoarce o promisiune, iar efectul are voie să întoarcă doar o funcție de curățare. Definește funcția async în interiorul efectului și apeleaz-o. TypeError: Cannot read properties of null (reading 'nume') Citești un câmp dintr-un obiect care încă este null, de obicei date care se încarcă în useEffect, dar sunt afișate deja la prima randare. Afișează o stare de încărcare până vin datele: if (!utilizator) return .... Î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.
