...
Eroare React · Liste, key și map

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

Pe scurt

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.

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

Ce înseamnă

Mesajul vine de la JavaScript: ai scris ceva.map(...), iar ceva este undefined. Partea (reading 'map') îți spune proprietatea pe care ai încercat s-o citești, deci caută în componentă un .map pe o variabilă care nu are încă valoare.

În React, cauza numărul unu este state-ul pornit fără valoare: useState() în loc de useState([]). Prima randare are loc imediat, înainte ca fetch din useEffect să aducă datele, deci la prima randare variabila e undefined și map aruncă eroarea. Alte cauze: un prop pe care părintele nu îl trimite sau un câmp care lipsește din răspunsul API-ului (data.produse când API-ul întoarce data.items).

Consola îți arată componenta și linia, de obicei chiar linia cu map.

De ce apare: cauzele frecvente

1State pornit fără tablou

Greșit
JSX
const [produse, setProduse] = useState();
useEffect(() => {
  fetch(URL).then((r) => r.json()).then(setProduse);
}, []);
return <ul>{produse.map((p) => <li key={p.id}>{p.nume}</li>)}</ul>;
Corect
JSX
const [produse, setProduse] = useState([]);
useEffect(() => {
  fetch(URL).then((r) => r.json()).then(setProduse);
}, []);
return <ul>{produse.map((p) => <li key={p.id}>{p.nume}</li>)}</ul>;

Cu [] prima randare afișează o listă goală, iar după fetch apare lista plină.

2Prop care nu a fost trimis

Greșit
JSX
function Lista({ produse }) {
  return <ul>{produse.map((p) => <li key={p.id}>{p.nume}</li>)}</ul>;
}
<Lista />
Corect
JSX
function Lista({ produse = [] }) {
  return <ul>{produse.map((p) => <li key={p.id}>{p.nume}</li>)}</ul>;
}
<Lista produse={produse} />

O valoare implicită în destructurare protejează componenta când prop-ul lipsește.

3Câmp greșit din răspunsul API

Greșit
JSX
// API-ul întoarce { items: [...] }
setProduse(data.produse);
Corect
JSX
// API-ul întoarce { items: [...] }
setProduse(data.items);

data.produse nu există, deci state-ul devine undefined. Verifică forma răspunsului cu console.log(data).

Repară tu

Repară eroarea, direct în pagină

Componenta de mai jos încarcă produsele de la https://api.exemplu.ro/produse și aruncă „Cannot read properties of undefined (reading 'map')” la prima randare. Repar-o ca lista să afișeze cele două produse primite (câte un li pentru fiecare).

Codul care dă eroarea
JSX
import { useState, useEffect } from "react";

export default function App() {
  const [produse, setProduse] = useState();

  useEffect(() => {
    fetch("https://api.exemplu.ro/produse")
      .then((r) => r.json())
      .then((date) => setProduse(date));
  }, []);

  return (
    <ul>
      {produse.map((p) => (
        <li key={p.id}>{p.nume}</li>
      ))}
    </ul>
  );
}
Indiciu

Ce valoare are produse înainte să vină răspunsul?

Alte forme ale mesajului

  • TypeError: Cannot read property 'map' of undefined
  • TypeError: undefined is not an object (evaluating 'produse.map')
  • TypeError: Cannot read properties of undefined (reading 'length')
  • TypeError: can't access property "map", produse is undefined

Cum o eviți pe viitor

  • Pornește state-ul cu o valoare de același tip ca datele finale: [] pentru liste, "" pentru texte.
  • Dă valori implicite props-urilor de tip listă: { produse = [] }.
  • Când datele pot lipsi, folosește produse?.map(...) sau afișează o stare de încărcare.
  • Verifică forma răspunsului API înainte să-l pui în state.

Întrebări frecvente

De ce eroarea apare chiar dacă datele vin corect din API?

Pentru că prima randare se face înainte de răspuns. Efectul cu fetch rulează după ce componenta a fost afișată o dată, cu valoarea inițială din useState.

E bine să folosesc produse?.map peste tot?

Este o plasă de siguranță bună când datele chiar pot lipsi. Dar dacă știi că e o listă, useState([]) este mai clar și elimină problema de la sursă.

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.