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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
formControlName="email" caută în grupul părinte un control cu cheia email. Dacă grupul nu o are, Angular aruncă eroarea. În Angular 20+ mesajul arată astfel: NG01055: Cannot find control with path: 'email'. Controls that do exist at this level: nume, telefon. Ultima parte e foarte utilă: îți listează exact controalele care există, deci vezi imediat greșeala de scriere (emial, Email, e-mail).
Cauze frecvente: ai adăugat câmpul în șablon, dar ai uitat să-l adaugi în FormGroup; ai redenumit controlul doar într-o parte; numele are majuscule diferite (cheile sunt sensibile la majuscule); sau controlul e adăugat condiționat (addControl) mai târziu decât randarea.
Reparația e să faci numele să coincidă în ambele locuri. Dacă un control apare doar uneori, afișează câmpul în @if cu aceeași condiție cu care adaugi controlul.
De ce apare: cauzele frecvente
1Control lipsă din grup
form = new FormGroup({
nume: new FormControl('')
});
<input formControlName="email" />form = new FormGroup({
nume: new FormControl(''),
email: new FormControl('')
});
<input formControlName="email" />Fiecare formControlName din șablon are nevoie de o cheie cu același nume în grup.
2Nume scris diferit
form = this.fb.group({ codPostal: [''] });
<input formControlName="codpostal" />form = this.fb.group({ codPostal: [''] });
<input formControlName="codPostal" />Cheile sunt sensibile la majuscule: codpostal și codPostal sunt controale diferite.
Repară eroarea, direct în pagină
Formularul de înscriere are în șablon câmpul formControlName="email", dar grupul nu are acest control și aplicația se oprește cu „Cannot find control with path: 'email'”. Adaugă controlul email în grup ca, după ce scrii „ana@exemplu.ro”, p#rezumat să afișeze „Ana – ana@exemplu.ro”.
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" />
<input id="email" formControlName="email" />
</form>
<p id="rezumat">{{ form.value.nume }} – {{ form.value.email }}</p>
`
})
export class App {
form = new FormGroup({
nume: new FormControl('Ana')
});
}Indiciu
Fiecare formControlName are nevoie de o cheie cu același nume în FormGroup.
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" />
<input id="email" formControlName="email" />
</form>
<p id="rezumat">{{ form.value.nume }} – {{ form.value.email }}</p>
`
})
export class App {
form = new FormGroup({
nume: new FormControl('Ana'),
email: new FormControl('')
});
}De ce merge
formControlName="email" a căutat cheia email în grup și a găsit doar nume, exact ce spunea mesajul („Controls that do exist at this level: nume”).
Cu email: new FormControl('') în grup, ambele câmpuri își găsesc controlul. Ce scrii în #email ajunge în form.value.email, iar paragraful afișează numele și adresa.
Alte forme ale mesajului
NG01055: Cannot find control with path: 'email'. Controls that do exist at this level: nume.Error: Cannot find control with name: 'email'
Cum o eviți pe viitor
- Scrie numele controalelor o singură dată, în clasă, și copiază-le în șablon.
- Citește lista „Controls that do exist at this level” din mesajul nou: arată exact ce nume sunt disponibile.
- Activează verificarea strictă a șabloanelor (
strictTemplates) și formularele tipizate: editorul îți semnalează numele greșite.
Întrebări frecvente
Ce înseamnă „at this level”?
Grupul în care s-a făcut căutarea. Într-un formular cu grupuri imbricate (formGroupName="adresa"), nivelul este grupul adresa, nu formularul principal.
De ce eroarea apare doar când bifez o opțiune?
Probabil câmpul apare în șablon (prin @if) înainte ca controlul să fie adăugat cu addControl. Adaugă controlul întâi sau folosește aceeași condiție pentru ambele.
Erori înrudite
Cannot find control with path: 'adrese -> 0 -> strada' Într-un FormArray de grupuri, șablonul caută controlul strada în grupul de la poziția 0, dar grupurile din array nu au acest control. Construiește fiecare grup din array cu toate controalele folosite în șablon (de obicei printr-o funcție comună). 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. TypeError: Cannot read properties of null (reading 'hasError') form.get('...') a întors null pentru că numele controlului e greșit sau controlul nu există încă, iar apoi ai apelat .hasError() pe null. Corectează numele, folosește form.controls.email (tipizat) sau verifică rezultatul cu ?. Î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.
