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 }}.
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
client = signal<Client | undefined>(undefined);
// șablon:
<h2>{{ client().nume }}</h2>@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
produs: any;
// șablon:
<p>{{ produs.pret }} lei</p>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ă
<p>{{ comanda().adresa.oras }}</p><p>{{ comanda().adresa?.oras ?? 'Fără adresă' }}</p>?. oprește evaluarea dacă adresa lipsește, iar ?? dă un text implicit.
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.
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.
Reparația
import { Component, signal } from '@angular/core';
interface Client { nume: string; oras: string; }
@Component({
selector: 'app-root',
template: `
@if (client(); as c) {
<h2 id="nume">{{ c.nume }}</h2>
} @else {
<h2 id="nume">Se încarcă...</h2>
}
`
})
export class App {
client = signal<Client | undefined>(undefined);
constructor() {
setTimeout(() => this.client.set({ nume: 'Andrei Popa', oras: 'Cluj' }), 300);
}
}De ce merge
La prima afișare client() întoarce undefined, iar undefined.nume aruncă eroarea. Angular nu mai poate desena componenta, deși datele ar sosi peste 300 ms.
Cu @if (client(); as c), blocul cu numele se afișează doar când signal-ul are o valoare, iar până atunci rămâne ramura @else. Când set pune clientul în signal, Angular reevaluează condiția și afișează numele.
Alte forme ale mesajului
ERROR TypeError: Cannot read properties of undefined (reading 'nume')TypeError: ctx.client is undefinedTypeError: 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 tipulT | undefinedși tratează lipsa. - Pentru date asincrone folosește
@if (date(); as d)sau?.în șablon. - Evită
anyși!: cu tipuri corecte șistrictTemplates, compilatorul îți arată problema înainte de rulare. - Pentru HTTP,
httpResource()sautoSignal(..., { 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
TypeError: Cannot read properties of null (reading 'nume') Șablonul citește o proprietate dintr-o valoare null: un signal pornit cu null, un produs negăsit (find întoarce undefined, dar API-urile întorc des null) sau o selecție golită. Verifică valoarea înainte: @if (produs(); as p) sau {{ produs()?.nume }}. TS2532: Object is possibly 'undefined'. TypeScript (și verificarea strictă a șabloanelor) vede că valoarea poate fi undefined, de exemplu rezultatul lui find(), și refuză să-i citești proprietățile direct. Tratează cazul: @if (produs(); as p), produs()?.nume sau o valoare implicită cu ??. TS2564: Property 'titlu' has no initializer and is not definitely assigned in the constructor. Un câmp al clasei are tip, dar nicio valoare inițială: @Input() titlu: string;. Cu strict activat, TypeScript cere o valoare. Dă o valoare implicită, folosește input() / input.required() sau marchează tipul ca opțional. TypeError: Cannot read properties of undefined (reading 'pret') Citești un @Input() în constructorul componentei copil, înainte ca părintele să-i fi dat valoarea, deci e încă undefined. Mută codul în ngOnInit (sau ngOnChanges) ori, în stilul nou, folosește input() și computed(). Î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.
