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} />
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
produse.map((p) => {
const props = { key: p.id, nume: p.nume };
return <Rand {...props} />;
})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
optiuni.map((o) => <Optiune {...o} />)
// o = { key: "ro", eticheta: "Română" }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
function Rand(props) {
return <li {...props} />;
}function Rand({ id, ...rest }) {
return <li key={id} {...rest} />;
}Nu împrăștia orbește un obiect despre care nu știi dacă are key.
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.
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} />.
Reparația
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 = { nume: p.nume };
return <Rand key={p.id} {...props} />;
})}
</ul>
);
}De ce merge
Cu transformarea JSX nouă, React citește key direct de pe tag, înainte de celelalte atribute. Când key era doar în obiectul împrăștiat, React trebuia să-l caute acolo și avertiza că forma va dispărea.
Acum obiectul conține doar datele componentei (nume), iar key={p.id} e explicit pe tag: lista se afișează la fel și nu mai primești avertismentul.
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
keymereu direct pe tagul dinmap:<Rand key={p.id} {...props} />. - Când împrăștii obiecte venite din afară, scoate întâi
keycu 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
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}>. 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}. Do not use Array index in keys Regula ESLint react/no-array-index-key te avertizează că folosești indexul din map ca key. Când lista se reordonează sau se șterge un element, React leagă starea și câmpurile de poziție, nu de element, și apar bife sau texte mutate pe alt rând. Folosește un id stabil: key={item.id}. Î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.
