...
Eroare Angular · Signals, input(), output() și model()

NG0951: Child query result is required but no value is available.

Pe scurt

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

Greșit
TypeScript
<input #campCautare>

camp = viewChild.required<ElementRef>('camp');
Corect
TypeScript
<input #camp>

camp = viewChild.required<ElementRef>('camp');

Textul din viewChild trebuie să fie exact numele de după #.

2Element într-un @if fals

Greșit
TypeScript
@if (editare()) {
  <input #camp>
}

camp = viewChild.required<ElementRef>('camp');
Corect
TypeScript
@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

Greșit
TypeScript
constructor() {
  this.camp().nativeElement.focus();
}
Corect
TypeScript
constructor() {
  afterNextRender(() => this.camp().nativeElement.focus());
}

afterNextRender rulează după ce Angular a creat elementele din șablon.

Repară tu

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

Codul care dă eroarea
TypeScript
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.

Alte forme ale mesajului

  • ERROR RuntimeError: NG0951: Child query result is required but no value is available. Find more at https://angular.dev/errors/NG0951
  • NG0951: Child query result is required but no value is available.

Cum o eviți pe viitor

  • Folosește .required doar 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() sau effect(), 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

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