...
Eroare Angular · Verificarea tipurilor în șabloane și TypeScript

TS2532: Object is possibly 'undefined'.

Pe scurt

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

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

Ce înseamnă

Cu strict: true și strictTemplates, TypeScript urmărește dacă o valoare poate lipsi. Tipul Produs | undefined înseamnă „poate fi un produs sau nimic”. Dacă citești produs().nume direct, compilatorul îți arată TS2532: Object is possibly 'undefined' (sau, în versiunile noi, TS18048: 'produs' is possibly 'undefined', cu numele variabilei).

Surse tipice de undefined în Angular: Array.find(), care întoarce undefined când nu găsește nimic; un signal<Produs | undefined>() pentru date care se încarcă; un viewChild(); câmpurile opționale din interfețe (adresa?: Adresa); toSignal() fără valoare inițială.

Eroarea e un avertisment util, nu o piedică: îți arată exact locurile în care, la rulare, ai primi „Cannot read properties of undefined”.

De ce apare: cauzele frecvente

1Rezultatul lui find() folosit direct

Greșit
TypeScript
produs = computed(() => this.produse().find(p => p.id === this.id()));
// șablon:
<h2>{{ produs().nume }}</h2>
Corect
TypeScript
@if (produs(); as p) {
  <h2>{{ p.nume }}</h2>
} @else {
  <p>Produs inexistent</p>
}

find() poate să nu găsească nimic; @if tratează ambele cazuri.

2Câmp opțional dintr-o interfață

Greșit
TypeScript
interface Client { nume: string; adresa?: { oras: string } }
// șablon:
{{ client().adresa.oras }}
Corect
TypeScript
{{ client().adresa?.oras ?? 'Fără adresă' }}

?. oprește citirea dacă adresa lipsește, ?? dă textul implicit.

3Folosirea lui ! ca să scapi de eroare

Greșit
TypeScript
{{ produs()!.nume }}
Corect
TypeScript
{{ produs()?.nume ?? '-' }}

! doar ascunde avertismentul; la rulare valoarea tot poate lipsi.

Repară tu

Repară eroarea, direct în pagină

Componenta afișează produsul cu id-ul din signal-ul id, găsit cu find(). Pentru id-ul 7 nu există produs: la build primești „TS2532: Object is possibly 'undefined'”, iar aici „Cannot read properties of undefined”. Tratează cazul ca #produs să afișeze „Produs inexistent”.

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

interface Produs { id: number; nume: string; }

@Component({
  selector: 'app-root',
  template: `<h2 id="produs">{{ produs().nume }}</h2>`
})
export class App {
  produse = signal<Produs[]>([
    { id: 1, nume: 'Laptop' },
    { id: 2, nume: 'Mouse' }
  ]);
  id = signal(7);
  produs = computed(() => this.produse().find(p => p.id === this.id()));
}
Indiciu

Folosește @if (produs(); as p) cu o ramură @else pentru produsul lipsă.

Alte forme ale mesajului

  • error TS2532: Object is possibly 'undefined'.
  • TS18048: 'produs' is possibly 'undefined'.
  • TS2531: Object is possibly 'null'.
  • TS18047: 'client' is possibly 'null'.

Cum o eviți pe viitor

  • Păstrează strict: true și strictTemplates: true: avertismentele astea previn erori reale.
  • Tratează explicit lipsa valorii: @if (x(); as v), ?., ??, sau o valoare implicită în cod.
  • Nu folosi ! decât când știi sigur că valoarea există (și poți explica de ce).
  • Pentru date asincrone, oferă o stare de încărcare în șablon.

Întrebări frecvente

TS2532 sau TS18048, care e diferența?

Aceeași problemă. Versiunile noi de TypeScript (4.8+) folosesc TS18048 și pun numele variabilei în mesaj („'produs' is possibly 'undefined'”), care e mai ușor de găsit.

Am pus @if înainte, dar tot primesc eroarea. De ce?

Dacă în @if (produs()) folosești din nou produs().nume, compilatorul nu poate fi sigur că al doilea apel întoarce aceeași valoare. Folosește alias: @if (produs(); as p) { {{ p.nume }} }.

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.