...
Eroare Angular · Erori de șablon și control flow

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

Pe scurt

Ș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 }}.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Angular evaluează expresiile din șablon de la prima afișare a componentei, înainte ca datele încărcate asincron (HTTP, setTimeout, un serviciu) să sosească. Dacă un câmp e undefined în acel moment și șablonul citește client.nume, JavaScript aruncă Cannot read properties of undefined (reading 'nume'). Numele din paranteză e proprietatea pe care încercai s-o citești; obiectul din fața ei e cel care lipsește.

În consolă eroarea apare cu stiva de apeluri în funcția șablonului (de exemplu App_Template) și cu ctx.client în mesajele mai vechi. Componenta rămâne nedesenată sau parțial desenată.

Compilatorul AOT cu strictTemplates ar fi semnalat problema la build (TS2532 / TS18048), dacă tipul câmpului permite undefined. Cu any sau ! problema ajunge abia la rulare.

De ce apare: cauzele frecvente

1Date încărcate mai târziu

Greșit
TypeScript
client = signal<Client | undefined>(undefined);
// șablon:
<h2>{{ client().nume }}</h2>
Corect
TypeScript
@if (client(); as c) {
  <h2>{{ c.nume }}</h2>
} @else {
  <p>Se încarcă...</p>
}

@if afișează blocul doar când valoarea există; până atunci arată mesajul de încărcare.

2Câmp declarat dar neinițializat

Greșit
TypeScript
produs: any;
// șablon:
<p>{{ produs.pret }} lei</p>
Corect
TypeScript
produs = signal({ nume: 'Mouse', pret: 120 });
// șablon:
<p>{{ produs().pret }} lei</p>

Un câmp fără valoare inițială e undefined la prima afișare. Dă-i o valoare sau tratează lipsa ei.

3Proprietate imbricată opțională

Greșit
TypeScript
<p>{{ comanda().adresa.oras }}</p>
Corect
TypeScript
<p>{{ comanda().adresa?.oras ?? 'Fără adresă' }}</p>

?. oprește evaluarea dacă adresa lipsește, iar ?? dă un text implicit.

Repară tu

Repară eroarea, direct în pagină

Componenta încarcă profilul clientului după 300 ms. Starter-ul citește client().nume din prima clipă și aruncă „Cannot read properties of undefined (reading 'nume')”. Afișează în #nume numele clientului când a sosit și, până atunci, „Se încarcă...” în același element.

Codul care dă eroarea
TypeScript
import { Component, signal } from '@angular/core';

interface Client { nume: string; oras: string; }

@Component({
  selector: 'app-root',
  template: `<h2 id="nume">{{ client().nume }}</h2>`
})
export class App {
  client = signal<Client | undefined>(undefined);

  constructor() {
    setTimeout(() => this.client.set({ nume: 'Andrei Popa', oras: 'Cluj' }), 300);
  }
}
Indiciu

Folosește @if (client(); as c) cu o ramură @else.

Alte forme ale mesajului

  • ERROR TypeError: Cannot read properties of undefined (reading 'nume')
  • TypeError: ctx.client is undefined
  • TypeError: Cannot read property 'nume' of undefined

Cum o eviți pe viitor

  • Dă fiecărui câmp o valoare inițială (listă goală [], obiect implicit) sau tipul T | undefined și tratează lipsa.
  • Pentru date asincrone folosește @if (date(); as d) sau ?. în șablon.
  • Evită any și !: cu tipuri corecte și strictTemplates, compilatorul îți arată problema înainte de rulare.
  • Pentru HTTP, httpResource() sau toSignal(..., { initialValue }) îți dau o valoare definită de la început.

Întrebări frecvente

Datele apar după o secundă, dar consola rămâne cu eroarea. De ce?

Eroarea s-a produs la prima afișare, când datele încă lipseau. Chiar dacă ulterior sosesc, prima evaluare a eșuat, iar în unele cazuri componenta rămâne într-o stare stricată. Tratează cazul undefined din șablon.

Care e diferența față de „reading 'x'” cu null?

Aceeași problemă, dar valoarea e null, nu undefined: de obicei un câmp inițializat explicit cu null sau un răspuns null de la server. Soluțiile sunt aceleași.

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.