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.
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ă
@for (p of produse(); track p.categorie) {
<app-rand [produs]="p" />
}@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
@for (nota of note(); track nota) {
<li>{{ nota }}</li>
}@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
adauga(nume: string) {
this.lista.update(l => [...l, { id: l.length, nume }]);
}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ă 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.
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.
Reparația
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.id) {
<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]);
}
}De ce merge
Angular refolosește elementele DOM după cheia din track. Cu p.categorie, Pâinea și Croissantul au aceeași cheie, brutarie. Când Croissantul apare la început, Angular îi dă primul rând existent cu cheia brutarie, adică rândul Pâinii, cu tot cu câmpul în care scria 5.
Cu track p.id, fiecare produs are o cheie proprie: rândul Pâinii e mutat pe poziția a doua cu valoarea lui, iar Croissantul primește un rând nou, cu câmpul gol.
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
idunic și stabil (de la server sau dintr-un contor) și foloseștetrack x.id. - Nu folosi la
trackcâ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
NG0956: The configured tracking expression (track by identity) caused re-creation of the entire collection of size 2. This is an expensive operation requiring destruction and subsequent creation of DOM nodes, directives, components etc. Bucla @for folosește track pe obiectul întreg (track p), iar lista a fost înlocuită cu obiecte noi, deci Angular a distrus și a recreat toate rândurile. Folosește un câmp unic și stabil: track p.id. @for loop must have a "track" expression Blocul @for din Angular cere obligatoriu o expresie track, care spune cum se identifică fiecare element din listă. Adaugă-o după listă: @for (p of produse(); track p.id) { ... }; dacă nu ai un id, folosește track $index. Cannot parse expression. @for loop expression must match the pattern "<identifier> of <expression>" Prima parte a lui @for nu are forma „element of listă”: ai scris in în loc de of, let în față sau ai inversat ordinea. Scrie @for (p of produse(); track p.id). Î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.
