NG0103: Infinite change detection while refreshing application views. Ensure views are not calling `markForCheck` on every template execution or that afterRender hooks always mark views for check.
Fiecare randare modifică o stare care cere încă o randare, la nesfârșit, iar Angular se oprește după un număr de încercări. De obicei un afterEveryRender sau un effect setează un signal citit în șablon la o valoare nouă de fiecare dată. Folosește afterNextRender sau setează valoarea doar când se schimbă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Angular rulează change detection în bucle: randează, apoi verifică dacă între timp s-a cerut altă randare (un signal modificat, markForCheck()). Dacă fiecare randare produce încă o cerere de randare, bucla nu se mai termină; după un număr de repetări Angular renunță și aruncă NG0103.
Mesajul îți spune unde să cauți: un view care apelează markForCheck la fiecare execuție a șablonului, sau un hook afterRender (afterEveryRender, fostul afterRender) care modifică mereu starea. Cel mai des e un afterEveryRender(() => this.contor.update(n => n + 1)): hook-ul rulează după fiecare randare, schimbă un signal citit în șablon, ceea ce cere o nouă randare, după care hook-ul rulează din nou.
Reparații: afterNextRender dacă ai nevoie de acțiune o singură dată (de exemplu măsurarea unui element), sau scrii în signal doar când valoarea chiar e diferită. În modul zoneless, NG0103 ia locul vechii bucle infinite care bloca pagina.
De ce apare: cauzele frecvente
1afterEveryRender care schimbă un signal din șablon
randari = signal(0);
constructor() {
afterEveryRender(() => this.randari.update(n => n + 1));
}randari = signal(0);
constructor() {
afterNextRender(() => this.randari.update(n => n + 1));
}afterNextRender rulează o singură dată, după prima randare, deci nu mai reaprinde bucla.
2Măsurare care scrie mereu o valoare nouă
afterEveryRender(() => {
this.latime.set({ px: this.cutie().nativeElement.offsetWidth });
});afterEveryRender(() => {
const px = this.cutie().nativeElement.offsetWidth;
if (px !== this.latime()) this.latime.set(px);
});Un obiect nou e mereu „diferit” pentru signal. Comparând numărul, scrii doar când lățimea chiar s-a schimbat.
Repară eroarea, direct în pagină
Componenta vrea să afișeze în p#pregatit „Pagina e pregătită (1)” după prima randare, dar folosește afterEveryRender care crește un contor la fiecare randare, iar aplicația se oprește cu NG0103. Fă ca acțiunea să ruleze o singură dată, după prima randare.
import { Component, signal, afterEveryRender, afterNextRender } from '@angular/core';
@Component({
selector: 'app-root',
template: `<p id="pregatit">Pagina e pregătită ({{ randari() }})</p>`
})
export class App {
randari = signal(0);
constructor() {
afterEveryRender(() => this.randari.update(n => n + 1));
}
}Indiciu
Există un hook care rulează doar după următoarea randare, nu după fiecare.
Reparația
import { Component, signal, afterEveryRender, afterNextRender } from '@angular/core';
@Component({
selector: 'app-root',
template: `<p id="pregatit">Pagina e pregătită ({{ randari() }})</p>`
})
export class App {
randari = signal(0);
constructor() {
afterNextRender(() => this.randari.update(n => n + 1));
}
}De ce merge
afterEveryRender rulează după fiecare randare. Callback-ul modifica randari, citit în șablon, deci cerea o nouă randare, după care callback-ul rula din nou. Ciclul nu se termina, iar Angular l-a oprit cu NG0103.
afterNextRender rulează o singură dată, după prima randare. Contorul devine 1, Angular randează încă o dată textul nou și apoi pagina se liniștește.
Alte forme ale mesajului
RuntimeError: NG0103: Infinite change detection while refreshing application views.
Cum o eviți pe viitor
- Folosește
afterNextRenderpentru lucruri care trebuie făcute o dată (focus, măsurare inițială, biblioteci externe). - În
afterEveryRenderși îneffect, nu scrie într-un signal citit în șablon decât dacă valoarea s-a schimbat. - Nu pune obiecte noi în signals la fiecare rulare: compară valorile simple.
- Evită
markForCheck()în metode apelate din șablon.
Întrebări frecvente
De ce nu se blochează pagina, ca la o buclă while?
Angular numără reîncercările de change detection și se oprește singur după o limită, aruncând NG0103. Fără limita asta, pagina ar îngheța.
Un effect poate produce aceeași eroare?
Da, dacă effect-ul citește și scrie același signal într-un mod care îl declanșează iar și iar, sau dacă scrie o stare care schimbă șablonul care, la rândul lui, re-declanșează effect-ul. Regula e aceeași: scrie doar când valoarea se schimbă.
Erori înrudite
NG0101: ApplicationRef.tick is called recursively Ai pornit manual change detection (appRef.tick()) chiar în timp ce Angular rula deja o detectare, de obicei dintr-un hook ca ngAfterViewChecked, ngDoCheck sau dintr-o metodă apelată în șablon. Scoate apelul manual și lasă signals să programeze randarea. NG0100: ExpressionChangedAfterItHasBeenCheckedError: Expression has changed after it was checked. Previous value: 'Se încarcă'. Current value: 'Gata'. O valoare afișată în șablon s-a schimbat după ce Angular tocmai o verificase, de obicei pentru că o modifici în ngAfterViewInit, într-un getter sau dintr-o componentă copil. Schimbă starea mai devreme (ngOnInit, câmp inițial) sau ține-o într-un signal. RangeError: Maximum call stack size exceeded O funcție se apelează pe ea însăși fără oprire până se umple stiva. În componentele Angular cauza tipică e un getter sau setter care își citește propriul nume (get pret() { return this.pret; }) în loc de câmpul privat _pret. Folosește alt nume pentru câmpul în care ții valoarea. Î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.
