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 }}.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul spune că expresia din fața punctului are valoarea null în momentul în care Angular o evaluează. În aplicațiile Angular, null apare de obicei intenționat: un signal pornit cu signal<Produs | null>(null) până alegi ceva, un răspuns de la server care spune „nu există”, o selecție resetată după ștergere. Problema e că șablonul nu tratează această stare.
Spre deosebire de undefined, null poate apărea și după ce pagina a mers: de exemplu, apeși „Șterge”, codul pune selecția la null, iar șablonul care afișa detaliile produsului selectat aruncă imediat.
Numele din paranteză e proprietatea citită; caută în șablon expresiile care o citesc și verifică ce valoare poate avea partea din stânga.
De ce apare: cauzele frecvente
1Selecție pornită sau resetată la null
selectat = signal<Produs | null>(null);
// șablon:
<p>{{ selectat().nume }}</p>@if (selectat(); as p) {
<p>{{ p.nume }}</p>
} @else {
<p>Alege un produs</p>
}Ramura cu detalii apare doar când există o selecție.
2Răspuns null de la API
<p>{{ profil().adresa.oras }}</p><p>{{ profil().adresa?.oras ?? 'Adresă necompletată' }}</p>Dacă serverul trimite adresa: null, operatorul ?. evită eroarea, iar ?? afișează un text clar.
3Element negăsit în DOM
const camp = document.querySelector('#email');
camp.focus();const camp = document.querySelector<HTMLInputElement>('#email');
camp?.focus();querySelector întoarce null dacă elementul nu există (încă). În Angular, preferă viewChild().
Repară eroarea, direct în pagină
Componenta afișează detaliile produsului selectat în #detalii. Butonul #sterge elimină selecția (o pune la null), iar starter-ul aruncă „Cannot read properties of null (reading 'nume')”. Repară șablonul ca după ștergere #detalii să afișeze „Niciun produs selectat”.
import { Component, signal } from '@angular/core';
interface Produs { nume: string; pret: number; }
@Component({
selector: 'app-root',
template: `
<p id="detalii">{{ selectat().nume }} - {{ selectat().pret }} lei</p>
<button id="sterge" (click)="selectat.set(null)">Șterge selecția</button>
`
})
export class App {
selectat = signal<Produs | null>({ nume: 'Tastatură', pret: 180 });
}Indiciu
Afișează detaliile doar când selectat() are o valoare, cu @if și @else.
Reparația
import { Component, signal } from '@angular/core';
interface Produs { nume: string; pret: number; }
@Component({
selector: 'app-root',
template: `
@if (selectat(); as p) {
<p id="detalii">{{ p.nume }} - {{ p.pret }} lei</p>
} @else {
<p id="detalii">Niciun produs selectat</p>
}
<button id="sterge" (click)="selectat.set(null)">Șterge selecția</button>
`
})
export class App {
selectat = signal<Produs | null>({ nume: 'Tastatură', pret: 180 });
}De ce merge
La pornire produsul există și totul merge. Butonul pune signal-ul la null, Angular reevaluează șablonul, iar selectat().nume devine null.nume, care aruncă eroarea.
Cu @if (selectat(); as p), detaliile se afișează doar când există un produs; după ștergere condiția e falsă și apare ramura @else. Aliasul p evită și apelarea repetată a signal-ului.
Alte forme ale mesajului
ERROR TypeError: Cannot read properties of null (reading 'nume')TypeError: Cannot read property 'nume' of nullTypeError: ctx.produs is null
Cum o eviți pe viitor
- Când un signal poate fi
null, scrie tipul explicit (signal<Produs | null>(null)) și tratează cazul în șablon. - Folosește
@if (x(); as v)pentru blocuri întregi și?./??pentru valori izolate. - Activează
strictTemplates(implicit în proiectele noi): compilatorul semnalează la build accesul la un câmp posibilnull. - După operații care resetează starea (ștergere, deconectare), verifică ce afișează pagina.
Întrebări frecvente
De ce eroarea apare doar după ce apăs un buton?
Pentru că butonul a pus o valoare la null (de exemplu a șters produsul selectat), iar șablonul care o citea fără verificare a fost reevaluat imediat după.
Ce aleg: null sau undefined pentru „nimic selectat”?
Oricare, dar consecvent. Mulți preferă null pentru „lipsă intenționată”, iar undefined pentru „încă neîncărcat”. Important e ca tipul să includă valoarea și șablonul să o trateze.
Erori înrudite
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 }}. 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 ??. NG8107: The left side of this optional chain operation does not include 'null' or 'undefined' in its type, therefore the '?.' operator can be replaced with the '.' operator. Ai folosit ?. pe o valoare care, după tipul ei, nu poate fi null sau undefined. Des, valoarea e un signal necitit (produs?.nume în loc de produs().nume). Citește signal-ul cu () și scoate ?. acolo unde nu e nevoie. Î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.
