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().
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
form = new FormGroup({
nume: new FormControl(''),
oras: new FormControl('')
});
this.form.setValue({ nume: 'Ana' });this.form.patchValue({ nume: 'Ana' });patchValue setează doar cheile primite și lasă restul controalelor neschimbate.
2Date de la server fără toate câmpurile
this.api.client(7).subscribe(c => this.form.setValue(c));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ă 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”.
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.
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="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.patchValue(client);
}
}De ce merge
setValue verifică faptul că obiectul primit are o valoare pentru fiecare control al grupului. Clientul avea doar nume, deci pentru oras lipsea valoarea, iar Angular a aruncat NG01002.
patchValue completează doar cheile existente în obiect: numele devine „Ana Ionescu”, iar orașul își păstrează valoarea inițială, „București”.
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
patchValuepentru date venite din exterior (server, URL,localStorage). - Păstrează
setValuepentru 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
NG01001: Cannot find form control at index: 1 Ai apelat setValue() pe un FormArray cu mai multe valori decât controale are array-ul. setValue nu adaugă controale noi: golește array-ul și adaugă câte un FormControl pentru fiecare valoare (clear() + push()). 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. NG01000: There are no form controls registered with this group yet. If you're using ngModel, you may want to check next tick (e.g. use setTimeout). Ai apelat setValue() pe un formular care încă nu are controale: de obicei un formular template-driven (ngForm) în ngOnInit sau ngAfterViewInit, înainte ca câmpurile cu ngModel să se înregistreze. Leagă valorile inițiale direct prin [(ngModel)] sau folosește patchValue. Î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.
