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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
viewChild('camp') (sau vechiul @ViewChild('camp')) întoarce un ElementRef, iar elementul DOM real e în .nativeElement. Angular completează interogarea abia după ce creează vederea componentei. Înainte de asta, sau dacă elementul nu există în șablon, interogarea întoarce undefined, iar undefined.nativeElement aruncă Cannot read properties of undefined (reading 'nativeElement').
Momentele în care încă nu ai elementul: constructorul, inițializarea câmpurilor și ngOnInit (pentru elementele din blocuri @if/@for). Ce mai poate da undefined: un nume #ref scris greșit sau un element într-un @if fals.
Pentru lucrul direct cu DOM-ul (focus, măsurători, biblioteci externe), momentul corect e afterNextRender() (sau ngAfterViewInit).
De ce apare: cauzele frecvente
1Citire în constructor
camp = viewChild<ElementRef>('camp');
constructor() {
this.camp()!.nativeElement.focus();
}camp = viewChild<ElementRef>('camp');
constructor() {
afterNextRender(() => this.camp()?.nativeElement.focus());
}afterNextRender rulează după ce elementele din șablon există.
2@ViewChild citit în ngOnInit
@ViewChild('grafic') grafic!: ElementRef;
ngOnInit() {
deseneaza(this.grafic.nativeElement);
}@ViewChild('grafic') grafic!: ElementRef;
ngAfterViewInit() {
deseneaza(this.grafic.nativeElement);
}În ngAfterViewInit vederea e creată și interogarea are rezultat.
3Element într-un @if fals
@if (editare()) { <input #camp> }
this.camp()!.nativeElement.select();@if (editare()) { <input #camp> }
this.camp()?.nativeElement.select();Când condiția e falsă, elementul nu există; ?. evită eroarea.
Repară eroarea, direct în pagină
La pornire, câmpul #oras trebuie completat cu orașul salvat, „Brașov”, prin viewChild. Starter-ul scrie valoarea direct în constructor și aruncă „Cannot read properties of undefined (reading 'nativeElement')”. Mută codul în afterNextRender, ca #oras să aibă valoarea „Brașov”.
import { Component, viewChild, ElementRef } from '@angular/core';
@Component({
selector: 'app-root',
template: `<input id="oras" #camp placeholder="Oraș">`
})
export class App {
camp = viewChild<ElementRef<HTMLInputElement>>('camp');
constructor() {
this.camp()!.nativeElement.value = 'Brașov';
}
}Indiciu
afterNextRender(() => ...) rulează după ce câmpul există în pagină.
Reparația
import { Component, viewChild, ElementRef, afterNextRender } from '@angular/core';
@Component({
selector: 'app-root',
template: `<input id="oras" #camp placeholder="Oraș">`
})
export class App {
camp = viewChild<ElementRef<HTMLInputElement>>('camp');
constructor() {
afterNextRender(() => {
const el = this.camp()?.nativeElement;
if (el) el.value = 'Brașov';
});
}
}De ce merge
În constructor, Angular încă nu a creat elementele din șablon, deci this.camp() întoarce undefined. Operatorul ! doar păcălește TypeScript; la rulare, undefined.nativeElement aruncă eroarea și componenta nu pornește.
afterNextRender amână codul până după prima randare. Atunci interogarea are elementul, iar câmpul primește valoarea „Brașov”.
Alte forme ale mesajului
ERROR TypeError: Cannot read properties of undefined (reading 'nativeElement')TypeError: this.camp is undefinedTypeError: Cannot read property 'nativeElement' of undefined
Cum o eviți pe viitor
- Lucrează cu DOM-ul doar în
afterNextRender,afterEveryRendersaungAfterViewInit. - Pentru elementele care pot lipsi, folosește
viewChild()(fără.required) și?.. - Pentru elementele care sunt mereu în șablon,
viewChild.required()îți dă o eroare clară (NG0951) dacă numele e greșit. - Evită
!pe interogări: ascunde exact problema asta.
Întrebări frecvente
De ce în stilul vechi mergea uneori în ngOnInit?
Cu @ViewChild('x', { static: true }), elementele care nu sunt în blocuri condiționale erau disponibile înainte de ngOnInit. Implicit (static: false) și cu viewChild(), rezultatul vine după crearea vederii.
Pot folosi document.querySelector în loc de viewChild?
Funcționează doar dacă elementul există deja, deci ai aceeași problemă de moment, plus că poate găsi elemente din alte componente. viewChild caută doar în șablonul componentei tale.
Erori înrudite
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. TypeError: Cannot read properties of undefined (reading 'nume') Șablonul citește o proprietate dintr-o valoare care e încă undefined, de obicei date care n-au sosit sau un câmp neinițializat ({{ client.nume }}). Afișează-le doar când există: @if (client(); as c) { {{ c.nume }} } sau {{ client()?.nume }}. 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.
