TypeError: Cannot destructure property 'tema' of 'useContext(...)' as it is undefined.
Componenta citește un Context care nu are un Provider deasupra ei, iar createContext() fără valoare implicită dă undefined. Învelește arborele în <TemaContext.Provider value={...}> sau dă contextului o valoare implicită.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
useContext(TemaContext) caută în sus, prin părinți, cel mai apropiat <TemaContext.Provider> și întoarce value-ul lui. Dacă nu găsește niciunul, întoarce valoarea implicită dată la createContext(...). Cu createContext() fără argument, valoarea implicită este undefined.
Mesajul apare când destructurezi rezultatul: const { tema } = useContext(TemaContext) devine const { tema } = undefined, iar JavaScript nu poate citi proprietăți din undefined. Partea 'useContext(...)' îți spune expresia (în unele bundlere apare ca '(0 , _react.useContext)(...)'), iar 'tema' este proprietatea.
Cauze tipice: Provider-ul lipsește, e pus mai jos decât componenta care îl folosește (de exemplu doar în jurul conținutului, nu și al antetului) sau ai două contexte diferite create din greșeală (importate din fișiere diferite).
De ce apare: cauzele frecvente
1Provider lipsă
const TemaContext = createContext();
export default function App() {
return <Antet />;
}const TemaContext = createContext();
export default function App() {
return (
<TemaContext.Provider value={{ tema: "intunecat" }}>
<Antet />
</TemaContext.Provider>
);
}Cu Provider-ul deasupra, useContext din Antet primește obiectul din value.
2Provider pus doar în jurul unei părți
<>
<Antet />
<AuthContext.Provider value={auth}>
<Pagina />
</AuthContext.Provider>
</><AuthContext.Provider value={auth}>
<Antet />
<Pagina />
</AuthContext.Provider>Antet era în afara Provider-ului, deci primea valoarea implicită.
3Hook personalizat cu verificare
export function useAuth() {
return useContext(AuthContext);
}export function useAuth() {
const ctx = useContext(AuthContext);
if (!ctx) throw new Error("useAuth trebuie folosit în <AuthProvider>.");
return ctx;
}Un mesaj clar te duce direct la cauză, în loc de o eroare de destructurare.
Repară eroarea, direct în pagină
Antetul de mai jos citește tema din TemaContext, dar aplicația nu are Provider și aruncă „Cannot destructure property 'tema' of 'useContext(...)' as it is undefined”. Învelește aplicația într-un TemaContext.Provider cu valoarea { tema: "intunecat" }, ca #tema să afișeze „Tema: intunecat”.
import { createContext, useContext } from "react";
const TemaContext = createContext();
function Antet() {
const { tema } = useContext(TemaContext);
return <p id="tema">Tema: {tema}</p>;
}
export default function App() {
return (
<div>
<Antet />
</div>
);
}Indiciu
useContext caută un Provider deasupra componentei.
Reparația
import { createContext, useContext } from "react";
const TemaContext = createContext();
function Antet() {
const { tema } = useContext(TemaContext);
return <p id="tema">Tema: {tema}</p>;
}
export default function App() {
return (
<TemaContext.Provider value={{ tema: "intunecat" }}>
<div>
<Antet />
</div>
</TemaContext.Provider>
);
}De ce merge
Fără Provider, useContext(TemaContext) întoarce valoarea implicită a contextului. createContext() a fost apelat fără argument, deci valoarea implicită este undefined, iar const { tema } = undefined aruncă eroarea.
<TemaContext.Provider value={{ tema: "intunecat" }}> pune obiectul la dispoziția tuturor componentelor din interior. Antet este acum sub Provider, deci useContext întoarce obiectul, iar destructurarea găsește tema.
Alte forme ale mesajului
TypeError: Cannot destructure property 'user' of '(0 , react__WEBPACK_IMPORTED_MODULE_0__.useContext)(...)' as it is undefined.TypeError: Cannot destructure property 'tema' of 'useContext(...)' as it is null.TypeError: useContext(...) is undefined
Cum o eviți pe viitor
- Pune Provider-ii cât mai sus în arbore (în
Appsau înmain.jsx), în jurul a tot ce îi folosește. - Expune contextul printr-un hook propriu (
useTema,useAuth) care verifică existența Provider-ului. - Creează fiecare context o singură dată, într-un fișier separat, și importă-l de acolo peste tot.
Întrebări frecvente
De ce cu createContext(null) primesc altă eroare?
Cu null ca valoare implicită, destructurarea dă „Cannot destructure property 'tema' of ... as it is null”, iar citirea directă dă „Cannot read properties of null”. Cauza e aceeași: lipsește Provider-ul.
Pot da o valoare implicită ca să scap de Provider?
Pentru valori fixe (de exemplu tema implicită), da: createContext({ tema: "luminos" }). Dacă valoarea trebuie să se schimbe (state), ai nevoie de Provider, pentru că doar el poate transmite state-ul.
Erori înrudite
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 .... useNavigate() may be used only in the context of a <Router> component. Componenta care apelează useNavigate (sau useLocation, useParams) nu se află în interiorul unui <BrowserRouter>. Mută router-ul mai sus (în jurul lui App) sau mută hook-ul într-o componentă randată în router. TypeError: setAprecieri is not a function Variabila pe care o apelezi ca setter nu este o funcție, cel mai des pentru că ai destructurat useState cu acolade ({ x, setX }) în loc de paranteze drepte ([x, setX]), ori setter-ul nu a fost trimis ca prop. Î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.
