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.
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()
const cod = "Comanda #4521";
const gasit = cod.match(/\d+/);
console.log(gasit[0]);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
interface Comanda { livrata: string | null }
const c: Comanda = { livrata: null };
console.log(c.livrata.toUpperCase());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
function lungime(s: string | null) {
return s.length;
}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ă 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.
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")}`);Cod poștal: 400123 Cod poștal: necunoscut
Indiciu
Dacă gasit e null, întoarce textul necunoscut; altfel, gasit[0].
Reparația
function codPostal(adresa: string): string {
const gasit = adresa.match(/\d{6}/);
if (gasit === null) {
return "necunoscut";
}
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")}`);De ce merge
String.match întoarce RegExpMatchArray | null: un tablou cu potrivirile sau null dacă nu găsește nimic, cum e cazul celei de-a doua adrese. Fără verificare, gasit[0] ar fi aruncat la rulare o eroare de tip. După if (gasit === null) return "necunoscut", TypeScript elimină null din tip, iar gasit[0] e sigur. Tipul de return rămâne string pe ambele drumuri.
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) saunull(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 pierzi0sau"".
Î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
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 TS2322: Type 'null' is not assignable to type 'string'. În modul strict, null nu face parte din tipul string. Dacă variabila sau câmpul poate fi gol, scrie tipul ca string | null; dacă nu, dă-i o valoare reală (de exemplu "") în loc de null. 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 ??. Î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.
