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 ....
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Ai scris ceva de forma utilizator.nume, iar utilizator este null. Partea (reading 'nume') îți spune proprietatea, deci găsești ușor linia: e acolo unde citești .nume dintr-o variabilă care poate fi goală.
În React, tiparul obișnuit este useState(null) pentru date care vin dintr-un API: e o alegere bună, pentru că null înseamnă clar „încă nu am datele”. Problema apare când JSX-ul presupune că datele există deja. Prima randare are loc înainte ca fetch să răspundă, deci la prima randare utilizator.nume este null.nume.
Aceeași eroare apare cu un useRef(null) citit în timpul randării (ref.current.value) sau cu un useContext fără provider, când contextul are valoarea implicită null.
De ce apare: cauzele frecvente
1Date încă neîncărcate
const [utilizator, setUtilizator] = useState(null);
useEffect(() => { /* fetch */ }, []);
return <h2>{utilizator.nume}</h2>;const [utilizator, setUtilizator] = useState(null);
useEffect(() => { /* fetch */ }, []);
if (!utilizator) return <p>Se încarcă...</p>;
return <h2>{utilizator.nume}</h2>;Până vin datele, componenta afișează starea de încărcare și nu mai citește din null.
2Câmp opțional dintr-un obiect
<p>Oraș: {comanda.adresa.oras}</p><p>Oraș: {comanda.adresa?.oras ?? "nespecificat"}</p>Optional chaining (?.) întoarce undefined în loc să arunce, iar ?? dă o valoare de rezervă.
3ref citit în timpul randării
const camp = useRef(null);
return <p>{camp.current.value}</p>;const [text, setText] = useState("");
return <input value={text} onChange={(e) => setText(e.target.value)} />;ref.current se completează abia după montare; pentru valori afișate folosește state.
Repară eroarea, direct în pagină
Profilul de mai jos încarcă utilizatorul de la https://api.exemplu.ro/profil și aruncă „Cannot read properties of null (reading 'nume')” la prima randare. Adaugă o stare de încărcare ca, după răspuns, #nume să afișeze „Ana Pop”, iar #oras „Cluj”.
import { useState, useEffect } from "react";
export default function App() {
const [utilizator, setUtilizator] = useState(null);
useEffect(() => {
fetch("https://api.exemplu.ro/profil")
.then((r) => r.json())
.then((date) => setUtilizator(date));
}, []);
return (
<div>
<h2 id="nume">{utilizator.nume}</h2>
<p id="oras">{utilizator.oras}</p>
</div>
);
}Indiciu
Până vine răspunsul, utilizator este null.
Reparația
import { useState, useEffect } from "react";
export default function App() {
const [utilizator, setUtilizator] = useState(null);
useEffect(() => {
fetch("https://api.exemplu.ro/profil")
.then((r) => r.json())
.then((date) => setUtilizator(date));
}, []);
if (!utilizator) return <p id="incarcare">Se încarcă...</p>;
return (
<div>
<h2 id="nume">{utilizator.nume}</h2>
<p id="oras">{utilizator.oras}</p>
</div>
);
}De ce merge
Componenta se randează prima dată imediat, cu utilizator = null, iar efectul cu fetch rulează abia după această randare. JSX-ul citește utilizator.nume chiar la prima trecere, adică null.nume, și React se oprește.
if (!utilizator) return <p>Se încarcă...</p>; tratează explicit starea „încă nu am datele”. Când vine răspunsul, setUtilizator declanșează o randare nouă, condiția devine falsă și se afișează profilul complet.
Alte forme ale mesajului
TypeError: Cannot read property 'nume' of nullTypeError: null is not an object (evaluating 'utilizator.nume')TypeError: Cannot read properties of null (reading 'value')TypeError: can't access property "nume", utilizator is null
Cum o eviți pe viitor
- Pentru fiecare cerere de date, gândește trei stări: încărcare, eroare, succes, și afișează-le explicit.
- Pune verificarea (
if (!date) return ...) imediat după hook-uri, înainte de JSX-ul care folosește datele. - Pentru câmpuri care pot lipsi, folosește
?.și??.
Întrebări frecvente
E mai bine useState(null) sau useState({})?
null e mai clar: înseamnă „nu am date încă” și te obligă să tratezi starea de încărcare. Cu {} nu primești eroarea la primul nivel, dar utilizator.adresa.oras va arunca oricum, iar pagina afișează câmpuri goale.
Diferența față de „reading ... of undefined”?
Doar valoarea: aici variabila este null (de obicei pusă intenționat, ca stare inițială), acolo este undefined (de obicei un prop lipsă sau useState() fără argument). Reparațiile sunt aceleași.
Erori înrudite
TypeError: Cannot read properties of undefined (reading 'map') Apelezi .map pe o variabilă care este undefined, de obicei pentru că datele nu s-au încărcat încă sau prop-ul nu a fost trimis. Pornește state-ul cu un tablou gol, useState([]), sau verifică variabila înainte de map. 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]). 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.
