...
Eroare Angular · Change detection și ciclul de viață

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.

Pe scurt

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

Greșit
TypeScript
randari = signal(0);
constructor() {
  afterEveryRender(() => this.randari.update(n => n + 1));
}
Corect
TypeScript
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ă

Greșit
TypeScript
afterEveryRender(() => {
  this.latime.set({ px: this.cutie().nativeElement.offsetWidth });
});
Corect
TypeScript
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ă tu

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.

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

Alte forme ale mesajului

  • RuntimeError: NG0103: Infinite change detection while refreshing application views.

Cum o eviți pe viitor

  • Folosește afterNextRender pentru lucruri care trebuie făcute o dată (focus, măsurare inițială, biblioteci externe).
  • În afterEveryRender și în effect, 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

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