NG01052: formGroup expects a FormGroup instance. Please pass one in.
[formGroup] a primit undefined sau null, de obicei pentru că grupul se creează abia după ce datele vin de la server sau în ngOnInit al altui obiect. Creează FormGroup-ul imediat (la declararea câmpului) și completează-l mai târziu cu patchValue.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
[formGroup]="form" are nevoie de un obiect FormGroup real chiar la prima randare. Dacă form este încă undefined (declarat cu form!: FormGroup; și creat mai târziu), directiva nu are ce lega și aruncă NG01052. Mesajul include și un exemplu: un <div [formGroup]="myGroup"> cu grupul creat în clasă.
Se întâmplă cel mai des la formularele de editare: grupul se construiește în subscribe-ul care primește datele de la server, deci la prima randare nu există. Alte cauze: o greșeală de scriere în șablon ([formGroup]="fomr"), sau un grup creat într-un if care nu se execută.
Tiparul corect: creezi grupul imediat, cu valori goale, și apelezi patchValue(date) când sosesc datele. Alternativ, învelești formularul în @if (form) { ... }, dar atunci formularul nu apare deloc până vin datele.
De ce apare: cauzele frecvente
1Grupul creat după sosirea datelor
form!: FormGroup;
constructor() {
this.api.client(7).subscribe(c => {
this.form = new FormGroup({ nume: new FormControl(c.nume) });
});
}form = new FormGroup({ nume: new FormControl('') });
constructor() {
this.api.client(7).subscribe(c => this.form.patchValue(c));
}Grupul există de la început; patchValue doar îi completează valorile când vin datele.
2Nume greșit în șablon
<form [formGroup]="formular">
form = new FormGroup({ ... });<form [formGroup]="form">
form = new FormGroup({ ... });O proprietate inexistentă în clasă este undefined în șablon, cu același efect.
Repară eroarea, direct în pagină
Formularul de editare a profilului își creează grupul abia când sosesc datele (simulate cu setTimeout), iar aplicația se oprește cu NG01052. Creează grupul imediat, cu valori goale, și completează-l cu patchValue când sosesc datele, ca #nume să aibă valoarea „Ion Popescu”.
import { Component } from '@angular/core';
import { ReactiveFormsModule, FormGroup, FormControl } from '@angular/forms';
@Component({
selector: 'app-root',
imports: [ReactiveFormsModule],
template: `
<form [formGroup]="form">
<input id="nume" formControlName="nume" />
</form>
`
})
export class App {
form!: FormGroup;
constructor() {
setTimeout(() => {
this.form = new FormGroup({ nume: new FormControl('Ion Popescu') });
}, 50);
}
}Indiciu
Grupul trebuie să existe de la prima randare; datele se completează ulterior.
Reparația
import { Component } from '@angular/core';
import { ReactiveFormsModule, FormGroup, FormControl } from '@angular/forms';
@Component({
selector: 'app-root',
imports: [ReactiveFormsModule],
template: `
<form [formGroup]="form">
<input id="nume" formControlName="nume" />
</form>
`
})
export class App {
form = new FormGroup({ nume: new FormControl('') });
constructor() {
setTimeout(() => {
this.form.patchValue({ nume: 'Ion Popescu' });
}, 50);
}
}De ce merge
La prima randare, form era încă undefined, pentru că grupul se crea abia în setTimeout. [formGroup] a primit undefined și a aruncat NG01052.
Acum grupul există de la început, cu un nume gol, deci formularul se leagă imediat. Când sosesc datele, patchValue scrie valoarea în control, iar controlul o trimite singur în câmpul din pagină.
Alte forme ale mesajului
Error: NG01052: formGroup expects a FormGroup instance. Please pass one in. Example: <div [formGroup]="myGroup"> <input formControlName="firstName"> </div>Error: formGroup expects a FormGroup instance. Please pass one in.
Cum o eviți pe viitor
- Declară formularele reactive cu valoare inițială:
form = this.fb.group({...}), nuform!: FormGroup. - Completează datele venite asincron cu
patchValuesaureset(date). - Evită operatorul
!la câmpurile folosite în șablon: ascunde exact cazul în care valoarea lipsește. - Dacă vrei să ascunzi formularul până vin datele, folosește un signal de încărcare, nu un grup lipsă.
Întrebări frecvente
De ce nu e prinsă eroarea de TypeScript?
Operatorul ! din form!: FormGroup îi spune compilatorului „am grijă eu, va exista”. TypeScript te crede, dar la rulare valoarea e undefined la prima randare.
patchValue sau setValue?
setValue cere valori pentru toate controalele și aruncă eroare dacă lipsește unul. patchValue completează doar ce primește, deci e mai potrivit pentru date venite de la server.
Erori înrudite
NG01050: formControlName must be used with a parent formGroup directive. You'll want to add a formGroup directive and pass it an existing FormGroup instance (you can create one in your class). Un câmp are formControlName, dar niciun element părinte nu are [formGroup]. formControlName caută controlul după nume într-un grup, deci are nevoie de el: pune [formGroup]="form" pe <form> sau folosește [formControl] pentru un câmp independent. NG01002: Must supply a value for form control with name: 'oras'. Ai apelat setValue() pe un FormGroup cu un obiect căruia îi lipsește o cheie (aici oras). setValue cere valori pentru toate controalele; pentru completare parțială folosește patchValue(). Cannot find control with name: 'email' Un câmp din șablon are formControlName="email", dar grupul din clasă nu are niciun control cu acest nume (lipsește sau e scris altfel). Adaugă controlul în FormGroup / fb.group sau corectează numele din șablon. Î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.
