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

error TS18048: 'produs' is possibly 'undefined'.

Pe scurt

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()

Greșit
TypeScript
const preturi = [12, 30, 7];
const scump = preturi.find((p) => p > 20);
console.log(scump.toFixed(2));
Corect
TypeScript
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

Greșit
TypeScript
const stoc = new Map<string, number>([["mere", 10]]);
const n = stoc.get("mere");
console.log(n + 1);
Corect
TypeScript
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

Greșit
TypeScript
function salut(nume?: string) {
  return nume.toUpperCase();
}
Corect
TypeScript
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ă tu

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

Codul care dă eroarea
TypeScript
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));
După reparație, programul afișează
Ana: 3 comenzi
Clientul 9 nu există
Indiciu

Verifică if (!client) înainte să folosești câmpurile lui.

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 un return timpuriu.
  • Folosește ?. pentru acces și ?? pentru valori implicite (nu ||, care înlocuiește și 0 sau "").
  • 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

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