error TS2532: Object is possibly 'undefined'.
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
const produse = [{ nume: "Pix", pret: 3 }];
console.log(produse.find((p) => p.nume === "Pix").pret);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
const istoric = ["a", "b"];
console.log(istoric.pop().toUpperCase());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
function cauta(id: number): string | undefined {
return id === 1 ? "Ana" : undefined;
}
console.log(cauta(2).length);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ă 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.
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`);
}Pix: 3.50 lei Riglă: 0.00 lei
Indiciu
Pentru un produs lipsă, prețul afișat trebuie să fie 0.
Reparația
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) ?? 0).toFixed(2)} lei`);
}De ce merge
cautaPret întoarce number | undefined, iar pentru „Riglă” chiar întoarce undefined, pentru că nu există în catalog. Apelul direct .toFixed(2) pe rezultat ar fi aruncat la rulare. Cu (cautaPret(nume) ?? 0), valoarea lipsă e înlocuită cu 0 înainte de formatare, deci expresia are mereu tipul number. ?? e mai potrivit decât ||: un preț real de 0 ar rămâne neschimbat.
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ă fieundefined, ș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
error TS18048: 'produs' is possibly 'undefined'. Variabila poate fi undefined (rezultat de la find(), Map.get(), un câmp opțional), iar tu o folosești ca și cum ar avea mereu valoare. Verifică înainte (if (produs)), folosește ?. și ?? pentru o valoare implicită, sau tratează explicit cazul lipsă. error TS18047: 'text' is possibly 'null'. Valoarea poate fi null (de exemplu rezultatul lui match(), un câmp declarat string | null), iar tu o folosești direct. Verifică înainte (if (text !== null)), folosește ?. și ??, sau tratează explicit lipsa valorii. error TS2345: Argument of type 'string | undefined' is not assignable to parameter of type 'string'. Trimiți unei funcții o valoare care poate fi undefined (câmp opțional, find(), Map.get()), dar parametrul acceptă doar string. Verifică valoarea înainte de apel, dă-i o valoare implicită cu ?? sau, dacă funcția poate trata lipsa, fă parametrul opțional. Î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.
