...
Eroare Angular · Formulare template-driven și reactive

NG01052: formGroup expects a FormGroup instance. Please pass one in.

Pe scurt

[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

Greșit
TypeScript
form!: FormGroup;

constructor() {
  this.api.client(7).subscribe(c => {
    this.form = new FormGroup({ nume: new FormControl(c.nume) });
  });
}
Corect
TypeScript
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

Greșit
TypeScript
<form [formGroup]="formular">

form = new FormGroup({ ... });
Corect
TypeScript
<form [formGroup]="form">

form = new FormGroup({ ... });

O proprietate inexistentă în clasă este undefined în șablon, cu același efect.

Repară tu

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

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

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({...}), nu form!: FormGroup.
  • Completează datele venite asincron cu patchValue sau reset(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

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