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

TypeError: Cannot read properties of undefined (reading 'nativeElement')

Pe scurt

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

Greșit
TypeScript
camp = viewChild<ElementRef>('camp');

constructor() {
  this.camp()!.nativeElement.focus();
}
Corect
TypeScript
camp = viewChild<ElementRef>('camp');

constructor() {
  afterNextRender(() => this.camp()?.nativeElement.focus());
}

afterNextRender rulează după ce elementele din șablon există.

2@ViewChild citit în ngOnInit

Greșit
TypeScript
@ViewChild('grafic') grafic!: ElementRef;

ngOnInit() {
  deseneaza(this.grafic.nativeElement);
}
Corect
TypeScript
@ViewChild('grafic') grafic!: ElementRef;

ngAfterViewInit() {
  deseneaza(this.grafic.nativeElement);
}

În ngAfterViewInit vederea e creată și interogarea are rezultat.

3Element într-un @if fals

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

this.camp()!.nativeElement.select();
Corect
TypeScript
@if (editare()) { <input #camp> }

this.camp()?.nativeElement.select();

Când condiția e falsă, elementul nu există; ?. evită eroarea.

Repară tu

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

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

Alte forme ale mesajului

  • ERROR TypeError: Cannot read properties of undefined (reading 'nativeElement')
  • TypeError: this.camp is undefined
  • TypeError: Cannot read property 'nativeElement' of undefined

Cum o eviți pe viitor

  • Lucrează cu DOM-ul doar în afterNextRender, afterEveryRender sau ngAfterViewInit.
  • 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

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