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

NG01002: Must supply a value for form control with name: 'oras'.

Pe scurt

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().

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

FormGroup.setValue(obj) este strictă: obiectul trebuie să aibă exact cheile grupului, nici mai multe, nici mai puține. Dacă lipsește una, Angular aruncă NG01002 cu numele controlului fără valoare ('oras'). Dacă ai o cheie în plus, primești o eroare înrudită: Cannot find form control with name: 'x'.

Situația obișnuită: datele de la server nu au toate câmpurile formularului (de exemplu clientul nu are încă oraș salvat), sau formularul a primit un control nou și codul de încărcare n-a fost actualizat.

Ai două variante: patchValue(obj), care completează doar cheile primite și le ignoră pe cele necunoscute, sau construiești obiectul complet ({ ...gol, ...date }) înainte de setValue. Pentru FormArray, același mesaj spune „form control at index: 1”.

De ce apare: cauzele frecvente

1setValue cu date parțiale

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

this.form.setValue({ nume: 'Ana' });
Corect
TypeScript
this.form.patchValue({ nume: 'Ana' });

patchValue setează doar cheile primite și lasă restul controalelor neschimbate.

2Date de la server fără toate câmpurile

Greșit
TypeScript
this.api.client(7).subscribe(c => this.form.setValue(c));
Corect
TypeScript
this.api.client(7).subscribe(c => this.form.setValue({ nume: '', oras: '', ...c }));

Pornind de la valori implicite pentru toate cheile, obiectul trimis la setValue e mereu complet.

Repară tu

Repară eroarea, direct în pagină

La încărcare, formularul de livrare primește doar numele clientului și îl setează cu setValue, iar aplicația se oprește cu „NG01002: Must supply a value for form control with name: 'oras'”. Completează formularul fără să ceri și orașul, ca #nume să aibă „Ana Ionescu”, iar #oras să rămână „București”.

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="oras" formControlName="oras" />
    </form>
  `
})
export class App {
  form = new FormGroup({
    nume: new FormControl(''),
    oras: new FormControl('București')
  });

  constructor() {
    const client: any = { nume: 'Ana Ionescu' };
    this.form.setValue(client);
  }
}
Indiciu

Există o metodă care completează doar cheile primite.

Alte forme ale mesajului

  • NG01002: Must supply a value for form control at index: 1.
  • Error: Must supply a value for form control with name: 'oras'.

Cum o eviți pe viitor

  • Folosește patchValue pentru date venite din exterior (server, URL, localStorage).
  • Păstrează setValue pentru cazurile în care vrei ca o cheie lipsă să fie semnalată ca eroare.
  • Cu formulare tipizate (Angular 14+), TypeScript îți arată cheile lipsă la setValue încă din editor.

Întrebări frecvente

Când e mai bun setValue decât patchValue?

Când vrei să fii sigur că ai setat tot formularul, de exemplu la resetarea completă după salvare. Eroarea te anunță imediat dacă ai uitat un câmp nou adăugat.

De ce nu primesc eroarea la build?

Primești, dacă formularul e tipizat și obiectul are un tip cunoscut. Datele de la server au de obicei tipul any sau un tip mai larg, așa că eroarea apare abia la rulare.

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.