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}.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
key îi spune lui React care element din listă este care, între două randări. Cu key={index}, identitatea unui rând este poziția lui. Cât timp lista doar se afișează, totul pare corect. Problemele apar când:
- ștergi un element din mijloc sau de la început;
- adaugi la început sau sortezi lista;
- rândurile au stare proprie (un
useStateîn componenta rândului) sau câmpuri necontrolate (bife, inputuri).
Exemplu: ștergi primul rând. Al doilea primește acum indexul 0, iar React crede că rândul cu cheia 0 a rămas și doar și-a schimbat textul. Bifa sau textul scris în primul rând rămâne pe loc și apare la elementul următor.
Regula react/no-array-index-key (din eslint-plugin-react, des activată în configurații precum Airbnb) prinde exact key={index}, key={i} sau key={"rand-" + i}. Indexul e acceptabil doar pentru liste statice, care nu se schimbă niciodată.
De ce apare: cauzele frecvente
1Ștergere dintr-o listă cu key={index}
{sarcini.map((s, i) => (
<li key={i}>
<input type="checkbox" /> {s.text}
</li>
))}{sarcini.map((s) => (
<li key={s.id}>
<input type="checkbox" /> {s.text}
</li>
))}Cu id, rândul șters dispare cu bifa lui cu tot; cu index, bifa rămâne pe poziție și trece la sarcina următoare.
2Elemente fără id
const [note, setNote] = useState([]);
setNote([...note, text]);
// ...
{note.map((n, i) => <Nota key={i} text={n} />)}const [note, setNote] = useState([]);
setNote([...note, { id: crypto.randomUUID(), text }]);
// ...
{note.map((n) => <Nota key={n.id} text={n.text} />)}Generezi id-ul o singură dată, când creezi elementul, și rămâne același la fiecare randare.
3Index ascuns într-un text
{produse.map((p, i) => <Card key={"card-" + i} {...p} />)}{produse.map((p) => <Card key={p.cod} {...p} />)}"card-" + i tot de poziție depinde. Orice valoare unică și stabilă din date (id, cod, email) e o cheie bună.
Repară eroarea, direct în pagină
Lista de cumpărături de mai jos folosește indexul ca key (ESLint: „Do not use Array index in keys”). Dacă bifezi „Pâine” și apoi ștergi primul rând, bifa trece la „Lapte”. Repar-o ca, după ștergerea primului rând, primul element să fie „Lapte” și să nu fie bifat.
import { useState } from "react";
export default function App() {
const [produse, setProduse] = useState([
{ id: 11, nume: "Pâine" },
{ id: 12, nume: "Lapte" },
{ id: 13, nume: "Ouă" },
]);
function sterge(index) {
setProduse(produse.filter((_, i) => i !== index));
}
return (
<ul>
{produse.map((p, i) => (
<li key={i}>
<input type="checkbox" /> {p.nume}
<button onClick={() => sterge(i)}>Șterge</button>
</li>
))}
</ul>
);
}Indiciu
Fiecare produs are deja un id: folosește-l ca key și la ștergere.
Reparația
import { useState } from "react";
export default function App() {
const [produse, setProduse] = useState([
{ id: 11, nume: "Pâine" },
{ id: 12, nume: "Lapte" },
{ id: 13, nume: "Ouă" },
]);
function sterge(id) {
setProduse(produse.filter((p) => p.id !== id));
}
return (
<ul>
{produse.map((p) => (
<li key={p.id}>
<input type="checkbox" /> {p.nume}
<button onClick={() => sterge(p.id)}>Șterge</button>
</li>
))}
</ul>
);
}De ce merge
Cu key={i}, React identifica rândurile după poziție. După ștergerea primului produs, „Lapte” a primit cheia 0, iar React a refolosit primul li, cu bifa lui cu tot, doar schimbându-i textul.
Cu key={p.id}, rândul cu id-ul 11 dispare complet, inclusiv bifa, iar rândurile 12 și 13 își păstrează propriile câmpuri. Ștergerea după id face și logica independentă de poziție.
Alte forme ale mesajului
Do not use Array index in keys react/no-array-index-keywarning Do not use Array index in keys react/no-array-index-key
Cum o eviți pe viitor
- Dă fiecărui element un
idcând îl creezi (crypto.randomUUID()sau id-ul din baza de date). - Nu genera cheia în
map(Math.random()sauDate.now()înkeye și mai rău: totul se recreează la fiecare randare). - Folosește indexul doar pentru liste statice, care nu se sortează, nu se filtrează și nu au stare pe rânduri.
- Testează lista ștergând primul element, după ce ai scris sau ai bifat ceva pe rânduri.
Întrebări frecvente
Dacă lista mea nu se schimbă niciodată, e o problemă indexul?
Nu. Pentru o listă fixă (de exemplu zilele săptămânii afișate o dată), indexul funcționează. Regula nu știe asta, așa că o poți dezactiva pe linia respectivă cu un comentariu eslint-disable-next-line.
De ce React nu mai dă avertismentul „unique key” dacă pun indexul?
Pentru că cheile sunt unice: 0, 1, 2. React verifică doar că există și că nu se repetă, nu și că sunt stabile. Stabilitatea o verifică regula ESLint.
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: 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}. Î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.
