...
Eroare React · Context și React Router

TypeError: Cannot destructure property 'tema' of 'useContext(...)' as it is undefined.

Pe scurt

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ă

Greșit
JSX
const TemaContext = createContext();
export default function App() {
  return <Antet />;
}
Corect
JSX
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

Greșit
JSX
<>
  <Antet />
  <AuthContext.Provider value={auth}>
    <Pagina />
  </AuthContext.Provider>
</>
Corect
JSX
<AuthContext.Provider value={auth}>
  <Antet />
  <Pagina />
</AuthContext.Provider>

Antet era în afara Provider-ului, deci primea valoarea implicită.

3Hook personalizat cu verificare

Greșit
JSX
export function useAuth() {
  return useContext(AuthContext);
}
Corect
JSX
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ă tu

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”.

Codul care dă eroarea
JSX
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.

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 App sau în main.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

← Toate erorile React

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.