...
Eroare React · useEffect și încărcarea datelor

TypeError: Cannot read properties of null (reading 'nume')

Pe scurt

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

Greșit
JSX
const [utilizator, setUtilizator] = useState(null);
useEffect(() => { /* fetch */ }, []);
return <h2>{utilizator.nume}</h2>;
Corect
JSX
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

Greșit
JSX
<p>Oraș: {comanda.adresa.oras}</p>
Corect
JSX
<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

Greșit
JSX
const camp = useRef(null);
return <p>{camp.current.value}</p>;
Corect
JSX
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ă tu

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

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

Alte forme ale mesajului

  • TypeError: Cannot read property 'nume' of null
  • TypeError: 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

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