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

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.

Pe scurt

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.

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

Ce înseamnă

Track by identity înseamnă track p: cheia fiecărui rând e chiar referința obiectului. Merge cât timp obiectele rămân aceleași, dar multe operații creează obiecte noi: un răspuns nou de la server, map(x => ({ ...x })), o copie pentru imutabilitate. Pentru Angular, fiecare obiect nou e alt element, așa că șterge toate rândurile din DOM și le creează din nou. În modul de dezvoltare primești NG0956, cu dimensiunea colecției recreate.

Costul nu e doar de performanță: elementele recreate își pierd starea. Textul scris într-un input necontrolat dispare, focusul se pierde, componentele copil pornesc de la zero, animațiile CSS repornesc.

Avertismentul apare când întreaga colecție (de o anumită dimensiune) e recreată la o singură actualizare.

De ce apare: cauzele frecvente

1Reîncărcare de la server cu track p

Greșit
TypeScript
@for (c of comenzi(); track c) {
  <app-comanda [comanda]="c" />
}
Corect
TypeScript
@for (c of comenzi(); track c.id) {
  <app-comanda [comanda]="c" />
}

Fiecare răspuns JSON creează obiecte noi, deci referințele diferă mereu. Id-ul rămâne același.

2Actualizare imutabilă a tuturor elementelor

Greșit
TypeScript
marcheazaCitite() {
  this.mesaje.update(l => l.map(m => ({ ...m, citit: true })));
}
// în șablon: track m
Corect
TypeScript
marcheazaCitite() {
  this.mesaje.update(l => l.map(m => ({ ...m, citit: true })));
}
// în șablon: track m.id

Copiile { ...m } sunt obiecte noi; cu track m.id Angular le recunoaște ca fiind aceleași mesaje și doar actualizează textul.

Repară tu

Repară eroarea, direct în pagină

Fiecare sarcină are un câmp .nota în care scrii o notiță. Butonul #reincarca înlocuiește lista cu copii noi ale obiectelor (ca un răspuns nou de la server). Starter-ul folosește track s, dă NG0956 și pierde notița scrisă. Repară cheia ca notița să rămână după reîncărcare.

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

@Component({
  selector: 'app-root',
  template: `
    <button id="reincarca" (click)="reincarca()">Reîncarcă</button>
    @for (s of sarcini(); track s) {
      <p>{{ s.titlu }}</p>
      <input class="nota">
    }
  `
})
export class App {
  sarcini = signal([
    { id: 1, titlu: 'Trimite factura' },
    { id: 2, titlu: 'Sună furnizorul' }
  ]);

  reincarca() {
    this.sarcini.set(this.sarcini().map(s => ({ ...s })));
  }
}
Indiciu

Folosește un câmp unic al sarcinii, nu obiectul întreg.

Alte forme ale mesajului

  • NG0956: The configured tracking expression (track by identity) caused re-creation of the entire collection of size 10. This is an expensive operation requiring destruction and subsequent creation of DOM nodes, directives, components etc. Please review the "track expression" and make sure that it uniquely identifies items in a collection.
  • WARNING: NG0956: The configured tracking expression (track by identity) caused re-creation of the entire collection

Cum o eviți pe viitor

  • Folosește track x.id pentru orice listă de obiecte, mai ales pentru cele venite din HTTP.
  • Lasă track x doar pentru liste de valori simple și unice (texte, numere).
  • Dacă datele nu au id, adaugă unul la încărcare (de exemplu dintr-un câmp unic, cum ar fi codul produsului).
  • Urmărește avertismentele NG0956 în consolă: arată exact listele care se redesenează inutil.

Întrebări frecvente

De ce am pierdut textul din câmpuri după ce am apăsat „Reîncarcă”?

Pentru că Angular a șters rândurile vechi și a creat altele noi. Câmpurile noi pornesc goale. Cu o cheie stabilă (track p.id), elementele existente sunt păstrate și doar datele lor se actualizează.

track p.id e mai lent decât track p?

Nu observabil. Citirea unui câmp e neglijabilă față de distrugerea și recrearea nodurilor DOM pe care o evită.

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.