...
Eroare Angular · Signals, input(), output() și model()

NG0203: effect() can only be used within an injection context such as a constructor, a factory function, a field initializer, or a function used with `runInInjectionContext`.

Pe scurt

effect() a fost creat într-o metodă, un callback sau un setTimeout. Angular trebuie să-l lege de componentă (ca să-l oprească la distrugere), deci îl acceptă doar în constructor sau la inițializarea unui câmp. Mută effect() acolo.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un effect() rulează din nou de fiecare dată când se schimbă signal-urile pe care le citește. Ca să nu rămână activ după ce componenta dispare, Angular îl leagă de injectorul componentei (prin DestroyRef). Injectorul e disponibil doar cât timp componenta e creată: în constructor și în inițializarea câmpurilor. Asta se numește injection context.

Dacă apelezi effect() mai târziu, de exemplu într-o metodă apelată la click, în ngOnInit sau într-un subscribe, Angular nu are de ce să-l lege și aruncă NG0203. Același mesaj apare pentru inject(), input(), toSignal() și alte funcții care cer contextul, cu numele funcției la început (în build-urile minificate numele poate fi scurtat, de exemplu Vn()).

Soluțiile: creezi efectul în constructor sau ca un câmp, ori, dacă chiar trebuie creat mai târziu, îi dai injectorul explicit: effect(fn, { injector: this.injector }).

De ce apare: cauzele frecvente

1effect() în ngOnInit

Greșit
TypeScript
ngOnInit() {
  effect(() => console.log(this.sold()));
}
Corect
TypeScript
constructor() {
  effect(() => console.log(this.sold()));
}

ngOnInit rulează după crearea componentei, în afara contextului de injecție.

2effect() creat la click

Greșit
TypeScript
pornesteSalvarea() {
  effect(() => localStorage.setItem('cos', JSON.stringify(this.cos())));
}
Corect
TypeScript
private salvare = effect(() => {
  if (this.salvareActiva()) {
    localStorage.setItem('cos', JSON.stringify(this.cos()));
  }
});

pornesteSalvarea() {
  this.salvareActiva.set(true);
}

Efectul e creat o dată, la inițializare; click-ul doar schimbă un signal pe care efectul îl citește.

3Efect creat mai târziu, cu injector explicit

Greșit
TypeScript
ngOnInit() {
  effect(() => this.log(this.filtru()));
}
Corect
TypeScript
private injector = inject(Injector);

ngOnInit() {
  effect(() => this.log(this.filtru()), { injector: this.injector });
}

Cu opțiunea injector, Angular știe de cine să lege efectul chiar și în afara constructorului.

Repară tu

Repară eroarea, direct în pagină

Componenta trebuie să actualizeze titlul paginii (document.title) cu numărul de mesaje necitite, de exemplu „(3) Inbox”, de la pornire și după fiecare click pe #nou. Starter-ul creează efectul la click și aruncă NG0203. Mută effect() în constructor, ca după un click titlul să fie „(4) Inbox”.

Codul care dă eroarea
TypeScript
import { Component, signal, effect } from '@angular/core';

@Component({
  selector: 'app-root',
  template: `<button id="nou" (click)="mesajNou()">Mesaj nou</button>`
})
export class App {
  necitite = signal(3);

  mesajNou() {
    this.necitite.update(n => n + 1);
    effect(() => {
      document.title = `(${this.necitite()}) Inbox`;
    });
  }
}
Indiciu

Creează efectul o singură dată, în constructor; click-ul doar crește signal-ul.

Alte forme ale mesajului

  • ERROR RuntimeError: NG0203: effect() can only be used within an injection context such as a constructor, a factory function, a field initializer, or a function used with `runInInjectionContext`. Find more at https://angular.dev/errors/NG0203
  • NG0203: input() can only be used within an injection context such as a constructor, a factory function, a field initializer, or a function used with `runInInjectionContext`.
  • NG0203: toSignal() can only be used within an injection context such as a constructor, a factory function, a field initializer, or a function used with `runInInjectionContext`.

Cum o eviți pe viitor

  • Declară efectele în constructor sau ca un câmp (private log = effect(...)).
  • Gândește efectul ca pe o „regulă permanentă”; ce vrei să pornești sau să oprești la click controlezi printr-un signal citit în efect.
  • Dacă trebuie creat mai târziu, folosește { injector } sau runInInjectionContext.
  • La fel pentru input(), output(), inject(), toSignal(): doar la inițializarea câmpurilor sau în constructor.

Întrebări frecvente

De ce în consolă apare Vn() sau alt nume ciudat în loc de effect()?

Într-un build minificat, numele funcțiilor sunt scurtate. Mesajul e același: funcția care cere context (aici effect) a fost apelată în afara lui. În modul de dezvoltare cu ng serve vezi numele real.

Trebuie să opresc manual un effect?

Nu, dacă e creat în componentă: Angular îl distruge odată cu ea. Dacă ai nevoie să-l oprești mai devreme, effect() întoarce un obiect cu metoda destroy().

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.