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

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.

Pe scurt

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

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

Ce înseamnă

key (la fel ca ref) este un prop special: React îl folosește intern ca să identifice elementele dintr-o listă și îl scoate din obiectul props înainte să apeleze componenta. Dacă în copil scrii function Rand({ key }) sau props.key, primești mereu undefined.

Avertismentul începe cu numele componentei care încearcă să citească cheia (aici Rand), deci știi exact în ce fișier să te uiți. Pagina nu se oprește, dar orice afișezi pe baza lui key lipsește.

Reparația este să trimiți aceeași valoare de două ori, sub două nume: key pentru React și un prop obișnuit pentru componentă.

De ce apare: cauzele frecvente

1Citirea lui key în componentă

Greșit
JSX
function Rand({ key, nume }) {
  return <li>{key}: {nume}</li>;
}

<Rand key={p.cod} nume={p.nume} />
Corect
JSX
function Rand({ cod, nume }) {
  return <li>{cod}: {nume}</li>;
}

<Rand key={p.cod} cod={p.cod} nume={p.nume} />

key rămâne pentru React, iar cod ajunge în props și poate fi afișat.

2Folosirea lui key într-un handler din copil

Greșit
JSX
function Sarcina(props) {
  return <button onClick={() => props.onSterge(props.key)}>Șterge</button>;
}
Corect
JSX
function Sarcina(props) {
  return <button onClick={() => props.onSterge(props.id)}>Șterge</button>;
}
// <Sarcina key={s.id} id={s.id} onSterge={sterge} />

Cu props.key ai fi trimis undefined la ștergere, deci nu s-ar fi șters nimic.

Repară tu

Repară eroarea, direct în pagină

Fiecare rând din lista de mai jos ar trebui să afișeze codul produsului în .cod (de exemplu „A1”), dar componenta Rand citește codul din key, iar consola spune „Rand: key is not a prop”. Trimite codul printr-un prop separat, numit cod, și păstrează cheia.

Codul care dă eroarea
JSX
const produse = [
  { cod: "A1", nume: "Mouse" },
  { cod: "B7", nume: "Cablu USB" },
];

function Rand({ key, nume }) {
  return (
    <li>
      <span className="cod">{key}</span> {nume}
    </li>
  );
}

export default function App() {
  return (
    <ul>
      {produse.map((p) => (
        <Rand key={p.cod} nume={p.nume} />
      ))}
    </ul>
  );
}
Indiciu

key rămâne pentru React; codul trebuie să ajungă printr-un alt prop.

Alte forme ale mesajului

  • Warning: ListItem: `key` is not a prop. Trying to access it will result in `undefined` being returned.
  • Warning: Card: `ref` is not a prop. Trying to access it will result in `undefined` being returned.

Cum o eviți pe viitor

  • Gândește-te la key ca la o etichetă pentru React, nu ca la date pentru componentă.
  • Dacă copilul are nevoie de id, trimite-l explicit: <Rand key={p.id} id={p.id} />.
  • Același lucru e valabil pentru ref în componentele funcție (React 18): ai nevoie de forwardRef.

Întrebări frecvente

Nu e o duplicare inutilă să trimit și key și id?

Pare, dar au roluri diferite: key ajută React să compare listele, id este o dată pe care componenta ta o folosește. Costul e zero.

Și ref se comportă la fel?

Da, în React 18 ref nu ajunge în props la componentele funcție. Pentru a primi un ref, componenta se învelește în forwardRef.

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.