@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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Spre deosebire de vechiul *ngFor, unde trackBy era opțional, noul control flow @for nu se compilează fără track. Expresia de după track îi spune lui Angular ce valoare identifică unic fiecare element. Când lista se schimbă (adaugi, ștergi, sortezi), Angular compară aceste chei și refolosește elementele DOM existente în loc să le distrugă și să le recreeze.
Mesajul apare la compilarea șablonului: la ng serve cu fișierul și rândul, în browser (JIT) după Errors during JIT compilation of template for App:. Fragmentul cu [ERROR ->] arată blocul @for cu problema.
Ce pui la track: un id unic (p.id, c.cod), elementul însuși pentru liste de valori simple care nu se repetă (track nume), sau $index dacă lista nu se reordonează și nu ai un id.
De ce apare: cauzele frecvente
1@for scris ca *ngFor, fără track
@for (p of produse()) {
<li>{{ p.nume }}</li>
}@for (p of produse(); track p.id) {
<li>{{ p.nume }}</li>
}track e obligatoriu în @for. Un id unic e cea mai bună alegere.
2track pus după alte opțiuni, fără punct și virgulă
@for (p of produse(); let i = $index track p.id) {
<li>{{ i + 1 }}. {{ p.nume }}</li>
}@for (p of produse(); track p.id; let i = $index) {
<li>{{ i + 1 }}. {{ p.nume }}</li>
}Opțiunile se despart prin ;. Fără separator, track e citit ca parte din let și nu e recunoscut.
3Listă de valori simple
@for (oras of orase) {
<option>{{ oras }}</option>
}@for (oras of orase; track oras) {
<option>{{ oras }}</option>
}Pentru texte sau numere unice, valoarea însăși poate fi cheia. Dacă se pot repeta, folosește track $index.
Repară eroarea, direct în pagină
Componenta trebuie să afișeze meniul restaurantului: câte un li.fel pentru fiecare fel de mâncare. Starter-ul dă eroarea „@for loop must have a "track" expression”. Adaugă expresia track folosind id-ul fiecărui fel.
import { Component, signal } from '@angular/core';
@Component({
selector: 'app-root',
template: `
<ul>
@for (f of meniu()) {
<li class="fel">{{ f.nume }} - {{ f.pret }} lei</li>
}
</ul>
`
})
export class App {
meniu = signal([
{ id: 1, nume: 'Ciorbă de burtă', pret: 28 },
{ id: 2, nume: 'Sarmale cu mămăligă', pret: 42 },
{ id: 3, nume: 'Papanași', pret: 25 }
]);
}Indiciu
După listă pune ; track f.id.
Reparația
import { Component, signal } from '@angular/core';
@Component({
selector: 'app-root',
template: `
<ul>
@for (f of meniu(); track f.id) {
<li class="fel">{{ f.nume }} - {{ f.pret }} lei</li>
}
</ul>
`
})
export class App {
meniu = signal([
{ id: 1, nume: 'Ciorbă de burtă', pret: 28 },
{ id: 2, nume: 'Sarmale cu mămăligă', pret: 42 },
{ id: 3, nume: 'Papanași', pret: 25 }
]);
}De ce merge
Blocul @for are nevoie de o cheie pentru fiecare element, ca Angular să poată compara lista veche cu cea nouă și să refolosească elementele li existente. Fără track, compilatorul de șabloane refuză blocul și componenta nu pornește.
Cu track f.id, fiecare fel e identificat după id-ul lui, unic și stabil. Dacă meniul s-ar sorta sau s-ar reîncărca, Angular ar muta elementele existente în loc să le recreeze.
Alte forme ale mesajului
NG5002: @for loop must have a "track" expressionErrors during JIT compilation of template for App: @for loop must have a "track" expression ("[ERROR ->]@for (p of produse()) {
Cum o eviți pe viitor
- Scrie
@formereu cu forma completă:@for (x of lista(); track x.id) { ... } @empty { ... }. - Dă fiecărui obiect din liste un
idstabil (de la server sau generat la creare). - Folosește
track $indexdoar pentru liste fixe, care nu se reordonează. - La migrarea de la
*ngFor, ruleazăng generate @angular/core:control-flow: adaugă singurătrack.
Întrebări frecvente
Ce aleg: track p.id sau track $index?
p.id când ai un id unic: Angular păstrează corect elementele la sortare, ștergere sau reîncărcare. $index merge pentru liste statice; la o listă care se reordonează, Angular ar refolosi elemente pentru alte date (de exemplu un câmp de text completat ar rămâne pe rândul greșit).
Pot folosi track p (obiectul întreg)?
Se compilează, dar dacă lista e reîncărcată de la server, obiectele sunt noi la fiecare încărcare, iar Angular recreează tot DOM-ul. În modul de dezvoltare primești avertismentul NG0956.
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. 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. 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). @empty block can only be used after an @for block. Blocul @empty nu urmează imediat după un @for: între ele e un element sau @empty e pus în interiorul buclei. Scrie-l lipit de acolada de închidere a lui @for: } @empty { ... }. Î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.
