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

Do not use Array index in keys

Pe scurt

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}

Greșit
JSX
{sarcini.map((s, i) => (
  <li key={i}>
    <input type="checkbox" /> {s.text}
  </li>
))}
Corect
JSX
{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

Greșit
JSX
const [note, setNote] = useState([]);
setNote([...note, text]);
// ...
{note.map((n, i) => <Nota key={i} text={n} />)}
Corect
JSX
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

Greșit
JSX
{produse.map((p, i) => <Card key={"card-" + i} {...p} />)}
Corect
JSX
{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ă tu

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.

Codul care dă eroarea
JSX
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.

Alte forme ale mesajului

  • Do not use Array index in keys react/no-array-index-key
  • warning Do not use Array index in keys react/no-array-index-key

Cum o eviți pe viitor

  • Dă fiecărui element un id când îl creezi (crypto.randomUUID() sau id-ul din baza de date).
  • Nu genera cheia în map (Math.random() sau Date.now() în key e ș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

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