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

NG0101: ApplicationRef.tick is called recursively

Pe scurt

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

Greșit
TypeScript
ngAfterViewChecked() {
  this.mesaj = 'Gata';
  this.appRef.tick();
}
Corect
TypeScript
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

Greșit
TypeScript
<p>{{ actualizeaza() }}</p>

actualizeaza() {
  this.appRef.tick();
  return this.total;
}
Corect
TypeScript
<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ă tu

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

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

Alte forme ale mesajului

  • Error: NG0101: ApplicationRef.tick is called recursively

Cum o eviți pe viitor

  • Nu apela ApplicationRef.tick() sau detectChanges() în hook-uri de ciclu de viață sau în metode din șablon.
  • Pentru starea care se schimbă asincron, folosește signals sau async pipe.
  • 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

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