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

Cannot find control with name: 'email'

Pe scurt

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

Greșit
TypeScript
form = new FormGroup({
  nume: new FormControl('')
});

<input formControlName="email" />
Corect
TypeScript
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

Greșit
TypeScript
form = this.fb.group({ codPostal: [''] });

<input formControlName="codpostal" />
Corect
TypeScript
form = this.fb.group({ codPostal: [''] });

<input formControlName="codPostal" />

Cheile sunt sensibile la majuscule: codpostal și codPostal sunt controale diferite.

Repară tu

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

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" />
      <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.

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

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