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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Până la Angular 20, change detection se baza pe zone.js, o bibliotecă ce „prinde” orice eveniment, timer sau cerere și anunță Angular să actualizeze ecranul. Clasa NgZone are nevoie ca zone.js să fie încărcat. Când creezi un NgZone real (sau aplicația e configurată să folosească zone) fără ca zone.js să existe în pagină, primești NG0908.
Apare în special după ce:
- scoți
zone.jsdinpolyfillsînangular.jsonca să treci la zoneless, dar uiți să adaugiprovideZonelessChangeDetection(); - faci upgrade și ai rămas cu
provideZoneChangeDetection()într-un proiect fără zone.js; - un cod sau o bibliotecă creează manual
new NgZone(...).
Ai două direcții: păstrezi zone.js (îl adaugi în polyfills și rămâi cu provideZoneChangeDetection), sau mergi complet pe zoneless: provideZonelessChangeDetection() (implicit în proiectele Angular noi) și stare în signals, pentru că fără zone.js un câmp simplu schimbat într-un setTimeout nu mai actualizează ecranul.
De ce apare: cauzele frecvente
1zone.js scos din polyfills, configurația a rămas pe zone
// angular.json: "polyfills": []
// app.config.ts
providers: [provideZoneChangeDetection({ eventCoalescing: true })]// app.config.ts
providers: [provideZonelessChangeDetection()]Fără zone.js, aplicația trebuie să ruleze în modul zoneless, unde actualizările vin din signals și evenimente din șablon.
2NgZone creat manual
private zona = new NgZone({ enableLongStackTrace: false });
constructor() {
setTimeout(() => this.zona.run(() => this.stare = 'Gata'));
}stare = signal('Se încarcă');
constructor() {
setTimeout(() => this.stare.set('Gata'));
}Un signal anunță singur schimbarea, deci nu mai e nevoie să rulezi codul „în zonă”.
Repară eroarea, direct în pagină
Componenta își creează manual un NgZone ca să actualizeze mesajul după un setTimeout, dar în aplicația zoneless de mai jos nu există zone.js și apare NG0908. Scoate NgZone și ține mesajul într-un signal, ca p#stare să afișeze „Comanda a fost livrată”.
import { Component, NgZone, signal } from '@angular/core';
@Component({
selector: 'app-root',
template: `<p id="stare">{{ stare }}</p>`
})
export class App {
private zona = new NgZone({ enableLongStackTrace: false });
stare = 'În curs de livrare';
constructor() {
setTimeout(() => this.zona.run(() => this.stare = 'Comanda a fost livrată'), 100);
}
}Indiciu
În zoneless, actualizarea ecranului vine din signals, nu din zone.
Reparația
import { Component, signal } from '@angular/core';
@Component({
selector: 'app-root',
template: `<p id="stare">{{ stare() }}</p>`
})
export class App {
stare = signal('În curs de livrare');
constructor() {
setTimeout(() => this.stare.set('Comanda a fost livrată'), 100);
}
}De ce merge
new NgZone(...) are nevoie de zone.js încărcat în pagină. Aplicația rulează în modul zoneless, fără zone.js, așa că Angular a aruncat NG0908 chiar la crearea componentei.
În zoneless, nu mai e nevoie să rulezi cod „în zonă” ca să se actualizeze ecranul. stare.set(...) din setTimeout anunță direct Angular că o valoare din șablon s-a schimbat, iar paragraful afișează noul mesaj.
Alte forme ale mesajului
Error: NG0908: In this configuration Angular requires Zone.js
Cum o eviți pe viitor
- Alege conștient modul: zoneless (
provideZonelessChangeDetection()) sau zone.js înpolyfills+provideZoneChangeDetection(), nu un amestec. - În zoneless, ține starea afișată în signals, folosește
asyncpipe sautoSignalpentru Observable-uri. - Caută în proiect
new NgZoneșiNgZone.run: în zoneless nu mai sunt necesare.
Întrebări frecvente
Angular 22 mai are nevoie de zone.js?
Nu, modul implicit în proiectele noi este zoneless. Zone.js rămâne opțional pentru aplicațiile mai vechi, care se bazează încă pe el; dacă îl folosești, trebuie încărcat în polyfills.
După ce am trecut la zoneless, unele valori nu se mai actualizează. De ce?
Fără zone.js, Angular nu mai află singur că ai schimbat un câmp într-un setTimeout, subscribe sau then. Pune acele valori în signals (sau folosește async pipe) și ecranul se actualizează din nou.
Erori înrudite
NG0408: Both provideZoneChangeDetection and provideZonelessChangeDetection are provided. This is likely a mistake. Update the application providers to use only one of the two. În configurația aplicației ai pus și provideZoneChangeDetection(), și provideZonelessChangeDetection(). Cele două moduri se exclud: păstrează-l doar pe cel pe care îl folosești (în proiectele noi, zoneless) și scoate-l pe celălalt. 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. Î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.
