...
Eroare TypeScript · null, undefined și unknown

error TS2532: Object is possibly 'undefined'.

Pe scurt

O expresie fără nume (rezultatul unui apel, un element dintr-un lanț) poate fi undefined și tu accesezi ceva pe ea. Salvează rezultatul într-o variabilă și verifică-l, sau folosește ?. și ??.

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

Ce înseamnă

Mesajul spune că „obiectul” din stânga punctului poate fi undefined. Diferența față de TS18048 e doar de formulare: când valoarea are un nume (o variabilă, o.x), TypeScript scrie 'nume' is possibly 'undefined'; când e o expresie fără nume, de exemplu rezultatul direct al unui apel gaseste().pret sau lista.pop().length, scrie „Object is possibly 'undefined'”.

Cauzele sunt aceleași: funcții care întorc T | undefined (find, pop, shift, Map.get, funcțiile tale cu tip | undefined) folosite direct, fără verificare.

Cea mai clară reparație: pui rezultatul într-o variabilă, verifici, apoi folosești. Dacă vrei o singură expresie, ?. oprește accesul la undefined, iar ?? dă o valoare de rezervă.

De ce apare: cauzele frecvente

1Rezultatul lui find() folosit direct

Greșit
TypeScript
const produse = [{ nume: "Pix", pret: 3 }];
console.log(produse.find((p) => p.nume === "Pix").pret);
Corect
TypeScript
const produse = [{ nume: "Pix", pret: 3 }];
console.log(produse.find((p) => p.nume === "Pix")?.pret ?? 0);

?. întoarce undefined în loc să arunce, iar ?? îl înlocuiește cu 0.

2pop() pe un tablou

Greșit
TypeScript
const istoric = ["a", "b"];
console.log(istoric.pop().toUpperCase());
Corect
TypeScript
const istoric = ["a", "b"];
const ultim = istoric.pop();
if (ultim) console.log(ultim.toUpperCase());

pop întoarce undefined pe un tablou gol. Variabila plus verificare e varianta cea mai clară.

3Funcția ta întoarce T | undefined

Greșit
TypeScript
function cauta(id: number): string | undefined {
  return id === 1 ? "Ana" : undefined;
}
console.log(cauta(2).length);
Corect
TypeScript
function cauta(id: number): string | undefined {
  return id === 1 ? "Ana" : undefined;
}
console.log(cauta(2)?.length ?? 0);

Tipul de return spune explicit că valoarea poate lipsi; apelantul trebuie să trateze cazul.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2532: Object is possibly 'undefined', pentru că rezultatul lui cautaPret e folosit direct. Folosește ?. și ?? (sau o verificare), ca programul să afișeze pe două linii Pix: 3.50 lei și Riglă: 0.00 lei.

Codul care dă eroarea
TypeScript
const catalog = new Map<string, number>([["Pix", 3.5], ["Caiet", 8]]);
function cautaPret(nume: string): number | undefined {
  return catalog.get(nume);
}
for (const nume of ["Pix", "Riglă"]) {
  console.log(`${nume}: ${cautaPret(nume).toFixed(2)} lei`);
}
După reparație, programul afișează
Pix: 3.50 lei
Riglă: 0.00 lei
Indiciu

Pentru un produs lipsă, prețul afișat trebuie să fie 0.

Alte forme ale mesajului

  • error TS2531: Object is possibly 'null'.
  • error TS2533: Object is possibly 'null' or 'undefined'.

Cum o eviți pe viitor

  • Nu înlănțui accesul direct după find, pop, get: pune rezultatul într-o variabilă și verifică-l.
  • Folosește ?. doar când e în regulă ca rezultatul să fie undefined, și combină-l cu ?? pentru afișare.
  • Dacă o funcție a ta poate să nu găsească nimic, spune-o în tip (| undefined) ca apelanții să fie obligați să verifice.

Întrebări frecvente

Mesajul e la fel cu „Cannot read properties of undefined”?

E aceeași problemă, prinsă mai devreme. TypeError: Cannot read properties of undefined e eroarea de rulare din JavaScript; TS2532 e avertismentul compilatorului că ea se poate întâmpla.

Există și „Object is possibly 'null'”?

Da, TS2531, cu aceeași logică pentru expresii care pot fi null. Pentru valori cu nume apare TS18047.

Erori înrudite

← Toate erorile TypeScript

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ță TypeScript de la zero, cu exerciții la fiecare lecție

Curs TypeScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.