...
Eroare React · Context și React Router

TypeError: Cannot read properties of undefined (reading 'Provider')

Pe scurt

Obiectul context pe care încerci să-l folosești (TemaContext.Provider) este undefined, aproape mereu din cauza importului: contextul e exportat implicit și îl imporți cu acolade, sau invers, sau numele nu se potrivește. Potrivește importul cu exportul din fișierul contextului.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

TemaContext.Provider citește proprietatea Provider din obiectul TemaContext. Dacă TemaContext este undefined, citirea aruncă această eroare înainte să se randeze ceva.

Contextele se țin de obicei într-un fișier separat (TemaContext.js) și se importă în mai multe locuri, așa că problema este aproape mereu legătura dintre export și import:

  • fișierul are export default TemaContext, iar tu scrii import { TemaContext } from "./TemaContext";
  • fișierul are export const TemaContext, iar tu scrii import TemaContext from "./TemaContext";
  • numele exportat e altul (ThemeContext), sau exportul lipsește cu totul.

Cu bundler-ele reale (Vite, webpack) vezi des și un avertisment de import în terminal. Linia din stack trace arată componenta care randează .Provider.

De ce apare: cauzele frecvente

1Import cu acolade pentru un export implicit

Greșit
JSX
// TemaContext.js
export default createContext("light");
// App.jsx
import { TemaContext } from "./TemaContext";
Corect
JSX
// TemaContext.js
export const TemaContext = createContext("light");
// App.jsx
import { TemaContext } from "./TemaContext";

Exportul cu nume și importul cu acolade trebuie să aibă același nume.

2Import implicit pentru un export cu nume

Greșit
JSX
// AuthContext.js
export const AuthContext = createContext(null);
// App.jsx
import AuthContext from "./AuthContext";
Corect
JSX
import { AuthContext } from "./AuthContext";

Un fișier fără export default nu are ce să dea unui import fără acolade.

3Context exportat cu alt nume

Greșit
JSX
export const ThemeContext = createContext("light");
// în alt fișier
import { TemaContext } from "./context";
Corect
JSX
export const TemaContext = createContext("light");
// în alt fișier
import { TemaContext } from "./context";

Numele din acolade trebuie să fie exact numele exportat.

Repară tu

Repară eroarea, direct în pagină

Aplicația de mai jos importă contextul temei din fișierul TemaContext.js, dar dă eroarea „Cannot read properties of undefined (reading 'Provider')”. Fără să modifici TemaContext.js, repară importul din App.jsx ca #tema să afișeze „Tema: dark”.

Codul care dă eroarea
JSX
import { TemaContext } from "./TemaContext";
import { useContext } from "react";

function Antet() {
  const tema = useContext(TemaContext);
  return <p id="tema">Tema: {tema}</p>;
}

export default function App() {
  return (
    <TemaContext.Provider value="dark">
      <Antet />
    </TemaContext.Provider>
  );
}
Indiciu

TemaContext.js are doar un export default, deci se importă fără acolade.

Alte forme ale mesajului

  • TypeError: Cannot read property 'Provider' of undefined
  • TypeError: undefined is not an object (evaluating 'TemaContext.Provider')
  • TypeError: can't access property "Provider", TemaContext is undefined
  • export 'TemaContext' (imported as 'TemaContext') was not found in './TemaContext' (possible exports: default)

Cum o eviți pe viitor

  • Alege o convenție pentru contexte și ține-te de ea: de exemplu, mereu export const XContext și import { XContext }.
  • Pune în același fișier și un hook propriu (export function useTema()), ca restul aplicației să nu mai importe contextul direct.
  • Când un import nu e găsit, citește avertismentul bundler-ului din terminal: îți spune ce exporturi există.

Întrebări frecvente

De ce useContext(TemaContext) nu dă eroare, dar .Provider da?

useContext(undefined) nu citește o proprietate, deci nu aruncă aceeași eroare (React doar avertizează). TemaContext.Provider citește proprietatea Provider dintr-un undefined, așa că eroarea apare imediat.

Poate fi și un import circular?

Da. Dacă fișierul contextului importă la rândul lui din App.jsx, contextul poate fi încă undefined când e folosit. Ține contextul într-un fișier care nu importă componente.

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.