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`.
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
ngOnInit() {
effect(() => console.log(this.sold()));
}constructor() {
effect(() => console.log(this.sold()));
}ngOnInit rulează după crearea componentei, în afara contextului de injecție.
2effect() creat la click
pornesteSalvarea() {
effect(() => localStorage.setItem('cos', JSON.stringify(this.cos())));
}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
ngOnInit() {
effect(() => this.log(this.filtru()));
}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ă 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”.
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.
Reparația
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);
constructor() {
effect(() => {
document.title = `(${this.necitite()}) Inbox`;
});
}
mesajNou() {
this.necitite.update(n => n + 1);
}
}De ce merge
effect() are nevoie de contextul de injecție al componentei, ca să știe când s-o oprească. La click, componenta e deja creată, contextul nu mai există, deci Angular aruncă NG0203 și titlul nu se schimbă.
Creat în constructor, efectul rulează o dată la pornire și apoi la fiecare schimbare a lui necitite. Click-ul doar crește signal-ul, iar efectul pune în titlu „(4) Inbox”.
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/NG0203NG0203: 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 }saurunInInjectionContext. - 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
NG0602: effect() cannot be called from within a reactive context. Call `effect` outside of a reactive context. For example, schedule the effect inside the component constructor. Ai creat un effect() în interiorul unui computed(), al altui effect sau al unei expresii din șablon. Acolo Angular urmărește dependențe, iar un efect nou s-ar crea la fiecare recalculare. Creează efectul o singură dată, în constructor. NG0600: Writing to signals is not allowed in a `computed`. Funcția din computed() modifică un signal (set, update). Un computed trebuie doar să calculeze și să întoarcă o valoare din alte signals. Mută modificarea într-o metodă sau într-un effect(), ori transformă signal-ul modificat într-un computed. NG0950: Input is required but no value is available yet. Un input.required() a fost citit înainte să primească valoare: părintele nu-l trimite deloc, sau componenta îl citește în constructor ori la inițializarea unui câmp. Trimite-l din părinte și citește-l doar în șablon, computed() sau ngOnInit. NG0203: inject() must be called from an injection context such as a constructor, a factory function, a field initializer, or a function used with `runInInjectionContext`. Ai apelat inject() într-un loc unde Angular nu mai creează nimic: într-o metodă, un handler de click, un setTimeout sau un subscribe. Mută inject() în inițializarea unui câmp sau în constructor și folosește câmpul în metodă. Î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.
