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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Cu strictNullChecks (inclus în strict), undefined nu mai e acceptat oriunde: un tip Produs | undefined trebuie verificat înainte să-i accesezi câmpurile sau metodele. TS18048 îți spune că valoarea cu numele produs poate fi undefined în locul în care o folosești.
Surse tipice: array.find() (poate să nu găsească nimic), map.get(), parametri și câmpuri opționale (?), array.pop(), JSON parsat cu câmpuri opționale. Pentru fiecare, TypeScript include undefined în tip, pentru că la rulare chiar se poate întâmpla.
Repari în trei feluri, după ce vrei să se întâmple când lipsește valoarea: oprești sau sari peste (if (!produs) return;), folosești o valoare implicită (produs?.pret ?? 0), sau, dacă ești absolut sigur că valoarea există, produs! (non-null assertion). Ultima variantă e o promisiune pe care o faci tu, nu o verificare.
De ce apare: cauzele frecvente
1Rezultatul lui find()
const preturi = [12, 30, 7];
const scump = preturi.find((p) => p > 20);
console.log(scump.toFixed(2));const preturi = [12, 30, 7];
const scump = preturi.find((p) => p > 20);
if (scump !== undefined) {
console.log(scump.toFixed(2));
}find întoarce number | undefined. După verificare, în if tipul e doar number (narrowing).
2Valoare din Map
const stoc = new Map<string, number>([["mere", 10]]);
const n = stoc.get("mere");
console.log(n + 1);const stoc = new Map<string, number>([["mere", 10]]);
const n = stoc.get("mere") ?? 0;
console.log(n + 1);get poate întoarce undefined pentru o cheie lipsă; ?? 0 dă o valoare implicită.
3Parametru opțional folosit direct
function salut(nume?: string) {
return nume.toUpperCase();
}function salut(nume?: string) {
return (nume ?? "vizitator").toUpperCase();
}Un parametru ? are tipul string | undefined; dai o valoare de rezervă sau folosești o valoare implicită în semnătură.
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS18048: 'client' is possibly 'undefined', pentru că find poate să nu găsească nimic. Tratează cazul lipsă cu o verificare, ca programul să afișeze pe două linii Ana: 3 comenzi și Clientul 9 nu există.
interface Client {
id: number;
nume: string;
comenzi: number;
}
const clienti: Client[] = [
{ id: 1, nume: "Ana", comenzi: 3 },
{ id: 2, nume: "Mihai", comenzi: 1 },
];
function raport(id: number): string {
const client = clienti.find((c) => c.id === id);
return `${client.nume}: ${client.comenzi} comenzi`;
}
console.log(raport(1));
console.log(raport(9));Ana: 3 comenzi Clientul 9 nu există
Indiciu
Verifică if (!client) înainte să folosești câmpurile lui.
Reparația
interface Client {
id: number;
nume: string;
comenzi: number;
}
const clienti: Client[] = [
{ id: 1, nume: "Ana", comenzi: 3 },
{ id: 2, nume: "Mihai", comenzi: 1 },
];
function raport(id: number): string {
const client = clienti.find((c) => c.id === id);
if (!client) {
return `Clientul ${id} nu există`;
}
return `${client.nume}: ${client.comenzi} comenzi`;
}
console.log(raport(1));
console.log(raport(9));De ce merge
find întoarce Client | undefined, pentru că se poate să nu existe niciun client cu id-ul cerut, exact cazul lui 9. În codul inițial, client.nume ar fi aruncat la rulare TypeError: Cannot read properties of undefined. Verificarea if (!client) return ... tratează lipsa, iar după ea TypeScript face narrowing: pe restul funcției client are tipul Client, deci accesul la câmpuri e sigur.
Alte forme ale mesajului
error TS18048: 'o.x' is possibly 'undefined'.
Cum o eviți pe viitor
- Tratează cazul „nu există” imediat după
find,get,pop: o verificare și unreturntimpuriu. - Folosește
?.pentru acces și??pentru valori implicite (nu||, care înlocuiește și0sau""). - Evită
!în afara cazurilor evidente; dacă ajungi să-l folosești des, probabil tipul ar trebui să nu conținăundefined.
Întrebări frecvente
Ce diferență e între TS18048 și TS2532?
Aceeași problemă. TS18048 apare când valoarea are un nume (variabilă, parametru, o.x), TS2532 („Object is possibly 'undefined'”) când e o expresie fără nume, de exemplu rezultatul unui apel.
De ce nu ajunge verificarea făcută într-o funcție separată?
Pentru că TypeScript nu știe ce face funcția, decât dacă e un type guard (function exista(x): x is Produs). Altfel, fă verificarea direct în cod sau folosește un type guard.
Erori înrudite
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 ??. 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.
