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

error TS18047: 'text' is possibly 'null'.

Pe scurt

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.

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

Ce înseamnă

TS18047 e perechea lui TS18048 pentru null: tipul variabilei include null, iar tu accesezi o proprietate sau apelezi o metodă pe ea. Cu strictNullChecks, TypeScript îți cere să tratezi cazul.

null apare de obicei când e pus explicit în tip, ca „lipsă intenționată” (dataLivrare: string | null), sau vine din API-uri care întorc null când nu găsesc nimic: string.match(), regex.exec(), JSON.parse("null"), iar în browser document.querySelector() și localStorage.getItem().

Repararea e aceeași ca la undefined: un if care oprește sau ocolește cazul (if (text === null) return;), acces opțional (text?.length), valoare implicită (text ?? ""). Verificarea if (text) elimină și null, și undefined, dar și textul gol, deci alege-o conștient.

De ce apare: cauzele frecvente

1Rezultatul lui match()

Greșit
TypeScript
const cod = "Comanda #4521";
const gasit = cod.match(/\d+/);
console.log(gasit[0]);
Corect
TypeScript
const cod = "Comanda #4521";
const gasit = cod.match(/\d+/);
console.log(gasit ? gasit[0] : "fără număr");

match întoarce null dacă nu găsește nimic. Verificarea alege ce afișezi în fiecare caz.

2Câmp declarat explicit cu null

Greșit
TypeScript
interface Comanda { livrata: string | null }
const c: Comanda = { livrata: null };
console.log(c.livrata.toUpperCase());
Corect
TypeScript
interface Comanda { livrata: string | null }
const c: Comanda = { livrata: null };
console.log(c.livrata?.toUpperCase() ?? "în curs");

?. se oprește la null și întoarce undefined, iar ?? pune textul implicit.

3Parametru care acceptă null

Greșit
TypeScript
function lungime(s: string | null) {
  return s.length;
}
Corect
TypeScript
function lungime(s: string | null) {
  if (s === null) return 0;
  return s.length;
}

După if (s === null) return, restul funcției știe că s e string.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS18047: 'gasit' is possibly 'null', pentru că match poate să nu găsească nimic. Tratează cazul null, ca programul să afișeze pe două linii Cod poștal: 400123 și Cod poștal: necunoscut.

Codul care dă eroarea
TypeScript
function codPostal(adresa: string): string {
  const gasit = adresa.match(/\d{6}/);
  return gasit[0];
}
console.log(`Cod poștal: ${codPostal("Str. Lungă 5, Cluj 400123")}`);
console.log(`Cod poștal: ${codPostal("Str. Scurtă 2, Iași")}`);
După reparație, programul afișează
Cod poștal: 400123
Cod poștal: necunoscut
Indiciu

Dacă gasit e null, întoarce textul necunoscut; altfel, gasit[0].

Alte forme ale mesajului

  • error TS18049: 'text' is possibly 'null' or 'undefined'.

Cum o eviți pe viitor

  • Alege o singură convenție pentru „lipsă”: undefined (câmpuri opționale) sau null (valoare golită explicit), nu amândouă la întâmplare.
  • După orice apel care poate întoarce null (match, exec), tratează rezultatul imediat.
  • Preferă ?? lui || pentru valori implicite, ca să nu pierzi 0 sau "".

Întrebări frecvente

De ce if (text) repară eroarea?

Pentru că în ramura adevărată text nu poate fi null (nici undefined, nici ""). TypeScript face narrowing și elimină null din tip.

Pot folosi text!.length?

Doar dacă știi sigur că nu e null în acel punct. ! nu verifică nimic la rulare; dacă greșești, primești TypeError: Cannot read properties of null.

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.