Warning: Each child in a list should have a unique "key" prop.
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
{produse.map((p) => (
<li>{p.nume}</li>
))}{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
{produse.map((p) => (
<div className="rand">
<span key={p.id}>{p.nume}</span>
</div>
))}{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
{comenzi.map((c) => <RandComanda comanda={c} />)}{comenzi.map((c) => <RandComanda key={c.id} comanda={c} />)}Și componentele proprii din listă au nevoie de key, pus acolo unde le creezi.
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.
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.
Reparația
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 key={p.id}>{p.nume} - {p.pret} lei</li>
))}
</ul>
);
}De ce merge
React compară lista nouă cu cea veche element cu element. Cu key={p.id} fiecare li are o identitate legată de produsul pe care îl afișează: dacă mâine „Tastatură” dispare, React știe exact ce nod să scoată și le păstrează neatinse pe celelalte.
Fără cheie, React se bazează pe poziție și te avertizează, pentru că la o listă care se schimbă nodurile pot fi refolosite pentru alte produse. Indexul ar opri avertismentul, dar ar avea aceeași problemă; id-ul din date este alegerea corectă.
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
keyimediat după ce scriimap, 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
Warning: Encountered two children with the same key, `fructe`. Keys should be unique so that components maintain their identity across updates. Două elemente din aceeași listă au primit aceeași valoare la key, deci React nu le mai poate deosebi. Folosește un câmp cu adevărat unic (id-ul), nu unul care se repetă, cum ar fi categoria sau numele. Warning: Rand: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. Componenta încearcă să citească props.key, dar key este rezervat pentru React și nu ajunge niciodată în props. Trimite valoarea printr-un prop separat, de exemplu id={p.id} sau cod={p.cod}. 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. Î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.
