TypeError: Cannot read properties of undefined (reading 'Provider')
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 scriiimport { TemaContext } from "./TemaContext"; - fișierul are
export const TemaContext, iar tu scriiimport 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
// TemaContext.js
export default createContext("light");
// App.jsx
import { TemaContext } from "./TemaContext";// 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
// AuthContext.js
export const AuthContext = createContext(null);
// App.jsx
import AuthContext from "./AuthContext";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
export const ThemeContext = createContext("light");
// în alt fișier
import { TemaContext } from "./context";export const TemaContext = createContext("light");
// în alt fișier
import { TemaContext } from "./context";Numele din acolade trebuie să fie exact numele exportat.
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”.
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.
Reparația
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>
);
}De ce merge
TemaContext.js are doar un export implicit (export default). Un import cu acolade caută un export cu numele TemaContext, care nu există, deci primești undefined, iar TemaContext.Provider aruncă eroarea.
import TemaContext from "./TemaContext" ia exportul implicit, adică obiectul creat de createContext. Provider-ul există acum, iar Antet primește valoarea „dark” prin useContext.
Alte forme ale mesajului
TypeError: Cannot read property 'Provider' of undefinedTypeError: undefined is not an object (evaluating 'TemaContext.Provider')TypeError: can't access property "Provider", TemaContext is undefinedexport '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șiimport { 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
Element type is invalid: expected a string (for built-in components) or a class/function (for composite components) but got: undefined. You likely forgot to export your component from the file it's defined in, or you might have mixed up default and named imports. Componenta pe care o folosești în JSX este undefined, de obicei pentru că ai importat-o cu acolade deși e exportată cu export default (sau invers), ori ai uitat să o exporți. Potrivește importul cu exportul. Warning: The `value` prop is required for the `<Context.Provider>`. Did you misspell it or forget to pass it? Un <Context.Provider> nu are prop-ul value, de obicei pentru că e scris greșit (valoare=, values=, theme=). Componentele din interior primesc atunci undefined, nu valoarea dorită (nici măcar pe cea implicită din createContext). Scrie exact value={...}. 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ă. Î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.
