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

Warning: Each child in a list should have a unique "key" prop.

Pe scurt

Elementele create cu map nu au prop-ul key, iar React nu le poate urmări între randări. Dă fiecărui element din listă o cheie stabilă și unică, de obicei id-ul din date: <li key={p.id}>.

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

Ce înseamnă

Când afișezi o listă cu map, React trebuie să știe, la următoarea randare, care element nou corespunde cărui element vechi. Pentru asta folosește prop-ul special key. Fără el, React te avertizează în consolă: Each child in a list should have a unique "key" prop.

Avertismentul nu oprește aplicația, iar lista se vede corect la prima afișare. Problemele apar când lista se schimbă: la ștergere, inserare sau reordonare, React poate refolosi nodurile greșite, iar textul scris într-un input, focusul sau starea unei componente copil „sar” la alt rând.

Sub mesaj, consola îți spune unde să cauți: „Check the render method of App” este componenta care face map, iar at li este elementul fără cheie. Cheia se pune pe elementul exterior întors din map, nu pe un copil al lui.

De ce apare: cauzele frecvente

1map fără key

Greșit
JSX
{produse.map((p) => (
  <li>{p.nume}</li>
))}
Corect
JSX
{produse.map((p) => (
  <li key={p.id}>{p.nume}</li>
))}

Fiecare li are acum o identitate stabilă, legată de produs, nu de poziție.

2key pus pe elementul interior

Greșit
JSX
{produse.map((p) => (
  <div className="rand">
    <span key={p.id}>{p.nume}</span>
  </div>
))}
Corect
JSX
{produse.map((p) => (
  <div className="rand" key={p.id}>
    <span>{p.nume}</span>
  </div>
))}

React se uită la cheia elementului întors direct de map, adică la div.

3Componentă din listă fără key

Greșit
JSX
{comenzi.map((c) => <RandComanda comanda={c} />)}
Corect
JSX
{comenzi.map((c) => <RandComanda key={c.id} comanda={c} />)}

Și componentele proprii din listă au nevoie de key, pus acolo unde le creezi.

Repară tu

Repară eroarea, direct în pagină

Lista de produse de mai jos se afișează, dar consola arată „Each child in a list should have a unique "key" prop”. Adaugă o cheie stabilă fiecărui li, folosind id-ul produsului. Lista trebuie să rămână cu trei produse, în ordinea din date.

Codul care dă eroarea
JSX
const produse = [
  { id: 11, nume: "Mouse", pret: 89 },
  { id: 12, nume: "Tastatură", pret: 199 },
  { id: 13, nume: "Monitor", pret: 899 },
];

export default function App() {
  return (
    <ul>
      {produse.map((p) => (
        <li>{p.nume} - {p.pret} lei</li>
      ))}
    </ul>
  );
}
Indiciu

Fiecare produs are deja un câmp id.

Alte forme ale mesajului

  • Warning: Each child in a list should have a unique "key" prop. Check the render method of `ListaProduse`.
  • Each child in a list should have a unique "key" prop. Check the top-level render call using <ul>.
  • Missing "key" prop for element in iterator react/jsx-key

Cum o eviți pe viitor

  • Scrie key imediat după ce scrii map, ca reflex.
  • Folosește un id care vine din date (id din baza de date, cod de produs, email unic).
  • Evită key={index} la liste care se pot sorta, filtra sau la care adaugi elemente la început, și nu folosi niciodată Math.random() ca cheie.
  • Dacă datele nu au id, generează-l o singură dată, când creezi elementul, nu la randare.

Întrebări frecvente

Pot folosi indexul din map ca key?

Avertismentul dispare, dar indexul este doar poziția. Dacă lista nu se schimbă niciodată (un meniu fix), merge. Dacă se pot șterge, insera sau sorta elemente, starea rândurilor se mută la alte date, iar bugurile sunt greu de găsit.

Cheia trebuie să fie unică în toată aplicația?

Nu, doar între frații din aceeași listă. Două liste diferite pot avea chei identice fără nicio problemă.

De ce nu pot citi props.key în componentă?

key este folosit de React și nu ajunge în props. Dacă ai nevoie de valoare și în copil, trimite-o separat, de exemplu id={p.id}.

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.