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

@for loop must have a "track" expression

Pe scurt

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

Greșit
TypeScript
@for (p of produse()) {
  <li>{{ p.nume }}</li>
}
Corect
TypeScript
@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ă

Greșit
TypeScript
@for (p of produse(); let i = $index track p.id) {
  <li>{{ i + 1 }}. {{ p.nume }}</li>
}
Corect
TypeScript
@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

Greșit
TypeScript
@for (oras of orase) {
  <option>{{ oras }}</option>
}
Corect
TypeScript
@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ă tu

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.

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

Alte forme ale mesajului

  • NG5002: @for loop must have a "track" expression
  • Errors 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 @for mereu cu forma completă: @for (x of lista(); track x.id) { ... } @empty { ... }.
  • Dă fiecărui obiect din liste un id stabil (de la server sau generat la creare).
  • Folosește track $index doar 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

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