...
Eroare Angular · Erori de șablon și control flow

NG0955: The provided track expression resulted in duplicated keys for a given collection. Adjust the tracking expression such that it uniquely identifies all the items in the collection.

Pe scurt

Expresia track din @for dă aceeași cheie pentru mai multe elemente (de exemplu track p.categorie). Angular nu mai poate ține evidența corectă a rândurilor. Folosește o valoare unică: track p.id.

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

Ce înseamnă

Cheia din track trebuie să identifice unic fiecare element. Când două elemente au aceeași cheie, Angular afișează în consolă avertismentul NG0955 (în modul de dezvoltare) și listează cheile duplicate: key "1" at index "0" and "1".

Avertismentul nu oprește aplicația, dar problema e reală: când lista se schimbă (adaugi un element la început, ștergi, sortezi), Angular refolosește elementele DOM după cheie. Cu chei duplicate poate da unui element nou rândul altuia, cu tot cu starea lui: textul scris într-un input, o bifă, o componentă copil cu stare internă. Simptomul tipic: după o adăugare, cantitatea introdusă „sare” pe alt produs.

Cauze: track pe un câmp care nu e unic (categorie, nume, pret), track pe valoarea însăși într-o listă cu valori repetate, id-uri generate greșit (de exemplu toate 0).

De ce apare: cauzele frecvente

1Track pe un câmp care se repetă

Greșit
TypeScript
@for (p of produse(); track p.categorie) {
  <app-rand [produs]="p" />
}
Corect
TypeScript
@for (p of produse(); track p.id) {
  <app-rand [produs]="p" />
}

Mai multe produse pot avea aceeași categorie; id-ul e unic.

2Track pe valoare într-o listă cu repetări

Greșit
TypeScript
@for (nota of note(); track nota) {
  <li>{{ nota }}</li>
}
Corect
TypeScript
@for (nota of note(); track $index) {
  <li>{{ nota }}</li>
}

Notele se pot repeta (două de 10). Pentru valori simple repetabile, $index e o cheie unică.

3Id-uri generate greșit

Greșit
TypeScript
adauga(nume: string) {
  this.lista.update(l => [...l, { id: l.length, nume }]);
}
Corect
TypeScript
private urmatorulId = 1;
adauga(nume: string) {
  this.lista.update(l => [...l, { id: this.urmatorulId++, nume }]);
}

l.length repetă id-uri după o ștergere. Un contor care doar crește dă mereu valori noi.

Repară tu

Repară eroarea, direct în pagină

Fiecare rând .rand are numele produsului și un câmp .cant pentru cantitate. Butonul #adauga pune un produs nou la începutul listei. Starter-ul folosește track p.categorie, dă avertismentul NG0955 și, după adăugare, cantitatea scrisă la „Pâine” ajunge la produsul nou. Repară cheia ca fiecare cantitate să rămână la produsul ei.

Codul care dă eroarea
TypeScript
import { Component, signal } from '@angular/core';

@Component({
  selector: 'app-root',
  template: `
    <button id="adauga" (click)="adauga()">Adaugă croissant</button>
    @for (p of produse(); track p.categorie) {
      <div class="rand">
        <span>{{ p.nume }}</span>
        <input class="cant" type="number">
      </div>
    }
  `
})
export class App {
  produse = signal([
    { id: 1, nume: 'Pâine', categorie: 'brutarie' },
    { id: 2, nume: 'Lapte', categorie: 'lactate' }
  ]);

  adauga() {
    this.produse.update(l => [{ id: 3, nume: 'Croissant', categorie: 'brutarie' }, ...l]);
  }
}
Indiciu

Fiecare produs are un id unic: folosește-l la track.

Alte forme ale mesajului

  • NG0955: The provided track expression resulted in duplicated keys for a given collection. Adjust the tracking expression such that it uniquely identifies all the items in the collection. Duplicated keys were: key "1" at index "0" and "1".
  • WARNING: NG0955: The provided track expression resulted in duplicated keys for a given collection.

Cum o eviți pe viitor

  • Dă fiecărui obiect un id unic și stabil (de la server sau dintr-un contor) și folosește track x.id.
  • Nu folosi la track câmpuri descriptive (nume, categorie, preț): se pot repeta oricând.
  • Pentru liste simple de valori care se pot repeta, folosește track $index.
  • Tratează avertismentele NG din consolă ca pe bug-uri: în producție nu mai apar, dar efectul rămâne.

Întrebări frecvente

E doar un avertisment. Pot să-l ignor?

Nu e recomandat. Rândurile se pot amesteca la actualizarea listei: un câmp completat, o bifă sau starea unei componente copil ajung la alt element. În producție avertismentul dispare, dar bug-ul rămâne.

De ce nu apare avertismentul la prima afișare?

Angular verifică cheile duplicate când compară lista nouă cu cea veche, deci de obicei îl vezi după prima modificare a listei (adăugare, ștergere, reîncărcare).

Erori înrudite

← Toate erorile Angular

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ță Angular de la zero, cu exerciții la fiecare lecție

Curs Angular: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.