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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
ApplicationRef.tick() este metoda care rulează change detection pentru toată aplicația. Angular o apelează singur (după evenimente, signals modificate etc.). Dacă o apelezi tu în timpul unei detectări (din ngAfterViewChecked, ngDoCheck, ngOnChanges, dintr-un getter din șablon), ai porni o detectare în interiorul alteia. Angular nu permite asta și aruncă NG0101.
Codul care duce aici încearcă de obicei să „forțeze” ecranul să se actualizeze după o schimbare făcută prea târziu. În aplicațiile cu zone.js apare mai ales la ngAfterViewChecked + tick(); în cele zoneless, la încercarea de a actualiza manual ce un signal ar fi actualizat singur.
Soluția: scoate tick() (și eventualele detectChanges() din hook-uri) și ține starea afișată în signals. Dacă chiar ai nevoie de o randare manuală (de exemplu dintr-o bibliotecă externă), apeleaz-o din afara ciclului Angular, nu dintr-un hook de randare.
De ce apare: cauzele frecvente
1tick() în ngAfterViewChecked
ngAfterViewChecked() {
this.mesaj = 'Gata';
this.appRef.tick();
}mesaj = signal('Se încarcă');
ngAfterViewInit() {
this.mesaj.set('Gata');
}Signal-ul programează singur randarea după ce runda curentă s-a terminat, deci nu mai e nevoie de tick().
2tick() într-o metodă apelată din șablon
<p>{{ actualizeaza() }}</p>
actualizeaza() {
this.appRef.tick();
return this.total;
}<p>{{ total() }}</p>
total = computed(() => this.cos().reduce((s, p) => s + p.pret, 0));Metodele din șablon rulează în timpul detectării. Orice tick() acolo e prin definiție recursiv.
Repară eroarea, direct în pagină
Componenta încearcă să afișeze „Gata” forțând randarea cu appRef.tick() din ngAfterViewChecked, iar aplicația se oprește cu „NG0101: ApplicationRef.tick is called recursively”. Ține mesajul într-un signal, setează-l în ngAfterViewInit și scoate apelul tick(). p#mesaj trebuie să afișeze „Gata”.
import { Component, ApplicationRef, AfterViewChecked, AfterViewInit, inject, signal } from '@angular/core';
@Component({
selector: 'app-root',
template: `<p id="mesaj">{{ mesaj }}</p>`
})
export class App implements AfterViewChecked {
private appRef = inject(ApplicationRef);
mesaj = 'Se încarcă';
ngAfterViewChecked() {
this.mesaj = 'Gata';
this.appRef.tick();
}
}Indiciu
Un signal modificat programează singur randarea; nu ai nevoie de tick().
Reparația
import { Component, AfterViewInit, signal } from '@angular/core';
@Component({
selector: 'app-root',
template: `<p id="mesaj">{{ mesaj() }}</p>`
})
export class App implements AfterViewInit {
mesaj = signal('Se încarcă');
ngAfterViewInit() {
this.mesaj.set('Gata');
}
}De ce merge
ngAfterViewChecked rulează chiar în interiorul unei detectări a schimbărilor. Apelul appRef.tick() de acolo pornea o detectare nouă în mijlocul celei curente, iar Angular a oprit aplicația cu NG0101.
Cu un signal, set('Gata') nu forțează nimic: doar anunță că valoarea s-a schimbat. Angular termină runda curentă și programează singur următoarea randare, în care paragraful afișează noul text.
Alte forme ale mesajului
Error: NG0101: ApplicationRef.tick is called recursively
Cum o eviți pe viitor
- Nu apela
ApplicationRef.tick()saudetectChanges()în hook-uri de ciclu de viață sau în metode din șablon. - Pentru starea care se schimbă asincron, folosește signals sau
asyncpipe. - Când integrezi o bibliotecă externă, actualizează un signal din callback-ul ei în loc să forțezi randarea.
Întrebări frecvente
Când e corect să apelez appRef.tick()?
Rar: în teste sau în cod de infrastructură care rulează în afara change detection (de exemplu după ce o bibliotecă non-Angular a terminat ceva). În componente obișnuite, signals fac treaba asta.
E aceeași problemă ca NG0103?
Sunt înrudite. NG0101 înseamnă o detectare pornită în interiorul alteia (apel direct, imediat). NG0103 înseamnă că detectările se tot cer una după alta, fără sfârșit.
Erori înrudite
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ă. 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. NG0908: In this configuration Angular requires Zone.js Aplicația folosește NgZone (direct sau prin provideZoneChangeDetection), dar zone.js nu este încărcat. Fie adaugi zone.js în polyfills, fie treci aplicația pe modul zoneless cu provideZonelessChangeDetection() și ții starea în signals. Î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.
