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

NG0908: In this configuration Angular requires Zone.js

Pe scurt

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.js din polyfills în angular.json ca să treci la zoneless, dar uiți să adaugi provideZonelessChangeDetection();
  • 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

Greșit
TypeScript
// angular.json: "polyfills": []
// app.config.ts
providers: [provideZoneChangeDetection({ eventCoalescing: true })]
Corect
TypeScript
// 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

Greșit
TypeScript
private zona = new NgZone({ enableLongStackTrace: false });

constructor() {
  setTimeout(() => this.zona.run(() => this.stare = 'Gata'));
}
Corect
TypeScript
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ă tu

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

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

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 în polyfills + provideZoneChangeDetection(), nu un amestec.
  • În zoneless, ține starea afișată în signals, folosește async pipe sau toSignal pentru Observable-uri.
  • Caută în proiect new NgZone și NgZone.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

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