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

Warning: A props object containing a "key" prop is being spread into JSX: let props = {key: someKey, nume: ...}; <Rand {...props} /> React keys must be passed directly to JSX without using spread: let props = {nume: ...}; <Rand key={someKey} {...props} />

Pe scurt

Ai pus key într-un obiect și l-ai împrăștiat cu {...props} pe un element. Cu noul JSX (React 18.3+, Vite), key trebuie scris direct pe tag. Scoate key din obiect și scrie <Rand key={p.id} {...props} />.

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

Ce înseamnă

key nu e un prop ca celelalte: React îl folosește ca să recunoască elementele unei liste între randări și nu îl dă mai departe componentei. Cu transformarea JSX nouă (react/jsx-runtime, folosită de Vite, Next.js și Create React App), React vrea să vadă key scris explicit pe tag, nu ascuns într-un obiect împrăștiat cu {...props}.

Din React 18.3, în dezvoltare, primești avertismentul de fiecare dată când obiectul împrăștiat conține key. Mesajul îți arată chiar forma corectă: obiectul fără key, iar key={someKey} pus separat pe tag.

Deocamdată lista merge, dar React a anunțat că forma cu spread va fi tratată diferit în versiunile viitoare. Situații tipice: construiești props pentru fiecare rând într-un map, primești din API obiecte care au deja un câmp key, sau dai mai departe {...rest} care conține key.

De ce apare: cauzele frecvente

1key în obiectul de props

Greșit
JSX
produse.map((p) => {
  const props = { key: p.id, nume: p.nume };
  return <Rand {...props} />;
})
Corect
JSX
produse.map((p) => {
  const props = { nume: p.nume };
  return <Rand key={p.id} {...props} />;
})

key pus direct pe tag e citit de React înainte de spread, cum cere noua transformare JSX.

2Obiecte din API care au deja câmpul key

Greșit
JSX
optiuni.map((o) => <Optiune {...o} />)
// o = { key: "ro", eticheta: "Română" }
Corect
JSX
optiuni.map(({ key, ...rest }) => <Optiune key={key} {...rest} />)

Destructurezi key separat, iar restul câmpurilor le împrăștii.

3Componentă care dă mai departe toate props

Greșit
JSX
function Rand(props) {
  return <li {...props} />;
}
Corect
JSX
function Rand({ id, ...rest }) {
  return <li key={id} {...rest} />;
}

Nu împrăștia orbește un obiect despre care nu știi dacă are key.

Repară tu

Repară eroarea, direct în pagină

Lista de mai jos construiește pentru fiecare produs un obiect props care conține și key, apoi îl împrăștie pe <Rand />. Cu noul JSX, React avertizează „A props object containing a "key" prop is being spread into JSX”. Mută key direct pe tag, ca lista să afișeze în continuare cele 2 produse.

Codul care dă eroarea
JSX
const produse = [
  { id: 1, nume: "Pâine" },
  { id: 2, nume: "Lapte" },
];

function Rand({ nume }) {
  return <li>{nume}</li>;
}

export default function App() {
  return (
    <ul>
      {produse.map((p) => {
        const props = { key: p.id, nume: p.nume };
        return <Rand {...props} />;
      })}
    </ul>
  );
}
Indiciu

Scoate key: p.id din obiect și scrie <Rand key={p.id} {...props} />.

Alte forme ale mesajului

  • Warning: A props object containing a "key" prop is being spread into JSX: let props = {key: someKey, eticheta: ...}; <Optiune {...props} /> React keys must be passed directly to JSX without using spread: let props = {eticheta: ...}; <Optiune key={someKey} {...props} />

Cum o eviți pe viitor

  • Scrie key mereu direct pe tagul din map: <Rand key={p.id} {...props} />.
  • Când împrăștii obiecte venite din afară, scoate întâi key cu destructurare.
  • Pune key înaintea lui {...props}, ca să fie ușor de văzut.
  • Actualizează React la 18.3 înainte de React 19: avertismentele de acolo arată ce se schimbă.

Întrebări frecvente

De ce n-am văzut avertismentul înainte?

A apărut în React 18.3 și doar cu transformarea JSX nouă. Proiectele cu React 18.2 sau cu React.createElement nu îl afișează, deși forma e la fel de descurajată.

Lista se afișează corect. Contează?

Azi merge, dar React a anunțat că key din spread nu va mai fi tratat la fel în viitor. Reparația e mică, iar codul devine și mai clar.

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.