NG0951: Child query result is required but no value is available.
Un viewChild.required() (sau contentChild.required()) nu găsește elementul căutat: numele variabilei #ref diferă, elementul e într-un @if fals, sau îl citești înainte ca vederea să fie creată. Verifică #ref-ul și citește interogarea după randare.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
viewChild.required('camp') caută în șablon un element marcat cu #camp (sau o componentă / directivă, dacă îi dai clasa) și promite că rezultatul există mereu. Când citești interogarea și elementul nu a fost găsit, Angular aruncă NG0951: Child query result is required but no value is available.
Cauzele: variabila din șablon are alt nume (#campNume vs 'camp'), elementul e într-un @if care e fals sau într-un @defer încă neîncărcat, ori interogarea e citită prea devreme (în constructor sau într-un câmp inițializat direct), înainte ca Angular să creeze elementele.
Varianta fără .required (viewChild('camp')) nu aruncă: întoarce undefined, iar eroarea apare mai departe, de obicei ca „Cannot read properties of undefined (reading 'nativeElement')”.
De ce apare: cauzele frecvente
1Nume diferit pentru variabila din șablon
<input #campCautare>
camp = viewChild.required<ElementRef>('camp');<input #camp>
camp = viewChild.required<ElementRef>('camp');Textul din viewChild trebuie să fie exact numele de după #.
2Element într-un @if fals
@if (editare()) {
<input #camp>
}
camp = viewChild.required<ElementRef>('camp');@if (editare()) {
<input #camp>
}
camp = viewChild<ElementRef>('camp');Dacă elementul poate lipsi, interogarea nu e obligatorie: folosește viewChild() și verifică undefined.
3Citire înainte de randare
constructor() {
this.camp().nativeElement.focus();
}constructor() {
afterNextRender(() => this.camp().nativeElement.focus());
}afterNextRender rulează după ce Angular a creat elementele din șablon.
Repară eroarea, direct în pagină
La pornire, câmpul de căutare trebuie completat cu ultima căutare, „laptop”, prin viewChild.required și afterNextRender. Starter-ul caută referința 'cautare', dar în șablon câmpul are alt nume, așa că Angular aruncă NG0951. Repară referința ca #cautare să aibă valoarea „laptop”.
import { Component, viewChild, ElementRef, afterNextRender } from '@angular/core';
@Component({
selector: 'app-root',
template: `<input id="cautare" #campCautare placeholder="Caută produse">`
})
export class App {
camp = viewChild.required<ElementRef<HTMLInputElement>>('cautare');
constructor() {
afterNextRender(() => {
this.camp().nativeElement.value = 'laptop';
});
}
}Indiciu
Numele de după # din șablon trebuie să fie același cu cel din viewChild.required.
Reparația
import { Component, viewChild, ElementRef, afterNextRender } from '@angular/core';
@Component({
selector: 'app-root',
template: `<input id="cautare" #cautare placeholder="Caută produse">`
})
export class App {
camp = viewChild.required<ElementRef<HTMLInputElement>>('cautare');
constructor() {
afterNextRender(() => {
this.camp().nativeElement.value = 'laptop';
});
}
}De ce merge
viewChild.required('cautare') caută în șablon un element marcat cu #cautare. Câmpul are însă #campCautare (atributul id nu contează pentru interogare), deci nu e găsit nimic. Când afterNextRender citește this.camp(), Angular aruncă NG0951.
Cu #cautare, interogarea găsește câmpul, iar după prima randare codul îi pune valoarea „laptop”.
Alte forme ale mesajului
ERROR RuntimeError: NG0951: Child query result is required but no value is available. Find more at https://angular.dev/errors/NG0951NG0951: Child query result is required but no value is available.
Cum o eviți pe viitor
- Folosește
.requireddoar pentru elemente care sunt mereu în șablon, în afara oricărui@if/@for/@defer. - Copiază numele variabilei din șablon direct în
viewChild('...'), sau folosește tipul componentei în loc de text. - Citește interogările în
afterNextRender,ngAfterViewInit,computed()saueffect(), nu în constructor. - Pentru elemente opționale,
viewChild()+?.e soluția corectă.
Întrebări frecvente
Când e disponibil rezultatul unui viewChild?
După ce Angular creează vederea componentei: în ngAfterViewInit, în afterNextRender și în orice citire ulterioară (șablon, computed, effect). În constructor și în ngOnInit nu e încă disponibil.
Diferența dintre viewChild și contentChild?
viewChild caută în șablonul propriu al componentei. contentChild caută în conținutul proiectat de părinte prin <ng-content>.
Erori înrudite
TypeError: Cannot read properties of undefined (reading 'nativeElement') Citești nativeElement dintr-un viewChild care încă nu are valoare: în constructor, în ngOnInit, sau elementul e într-un @if fals. Folosește elementul după randare (afterNextRender, ngAfterViewInit) și verifică undefined pentru elementele opționale. NG0950: Input is required but no value is available yet. Un input.required() a fost citit înainte să primească valoare: părintele nu-l trimite deloc, sau componenta îl citește în constructor ori la inițializarea unui câmp. Trimite-l din părinte și citește-l doar în șablon, computed() sau ngOnInit. NG0203: effect() can only be used within an injection context such as a constructor, a factory function, a field initializer, or a function used with `runInInjectionContext`. effect() a fost creat într-o metodă, un callback sau un setTimeout. Angular trebuie să-l lege de componentă (ca să-l oprească la distrugere), deci îl acceptă doar în constructor sau la inițializarea unui câmp. Mută effect() acolo. Î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.
