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

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

Pe scurt

Ș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

Greșit
TypeScript
selectat = signal<Produs | null>(null);
// șablon:
<p>{{ selectat().nume }}</p>
Corect
TypeScript
@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

Greșit
TypeScript
<p>{{ profil().adresa.oras }}</p>
Corect
TypeScript
<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

Greșit
TypeScript
const camp = document.querySelector('#email');
camp.focus();
Corect
TypeScript
const camp = document.querySelector<HTMLInputElement>('#email');
camp?.focus();

querySelector întoarce null dacă elementul nu există (încă). În Angular, preferă viewChild().

Repară tu

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

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

Alte forme ale mesajului

  • ERROR TypeError: Cannot read properties of null (reading 'nume')
  • TypeError: Cannot read property 'nume' of null
  • TypeError: 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 posibil null.
  • 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

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