error TS2869: Right operand of ?? is unreachable because the left operand is never nullish.
Partea din stânga lui ?? nu poate fi niciodată null sau undefined (e un literal, un obiect sau o expresie cu +), deci valoarea implicită din dreapta nu se folosește niciodată. De obicei lipsesc paranteze: scrie (a ?? 0) + b în loc de a + b ?? 0.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
a ?? b întoarce a, cu excepția cazului în care a e null sau undefined; atunci întoarce b. Dacă TypeScript vede că partea stângă nu poate fi niciodată „nullish”, înseamnă că b e cod mort, iar asta indică aproape mereu o greșeală.
Cea mai frecventă cauză e precedența: ?? are prioritate mai mică decât +, *, >, ===. pret + transport ?? 0 se citește (pret + transport) ?? 0, iar o adunare nu dă niciodată undefined (dă cel mult NaN). Ai vrut de fapt pret + (transport ?? 0).
Alte cauze: un literal sau un obiect scris direct în stânga ({} ?? implicit, 'text' ?? 'altul'), sau un șablon de text. Verificarea a apărut în TypeScript 5.6. Linia din mesaj arată expresia; pune paranteze în jurul valorii care chiar poate lipsi.
De ce apare: cauzele frecvente
1Lipsesc parantezele în jurul valorii opționale
function total(pret: number, transport?: number) {
return pret + transport ?? 0;
}function total(pret: number, transport?: number) {
return pret + (transport ?? 0);
}Parantezele aplică ?? doar lui transport, care chiar poate fi undefined.
2Comparație înainte de ??
function areStoc(stoc?: number) {
return stoc > 0 ?? false;
}function areStoc(stoc?: number) {
return (stoc ?? 0) > 0;
}Rezultatul unei comparații e mereu boolean, deci ?? false nu s-ar folosi niciodată.
3Literal în partea stângă
const titlu = `Comanda ${'x'}` ?? 'fără titlu';const nume: string | undefined = undefined;
const titlu = nume ?? 'fără titlu';Un șablon de text e mereu un string. ?? are sens doar pe o valoare care poate lipsi.
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS2869: Right operand of ?? is unreachable because the left operand is never nullish. Transportul poate lipsi. Repară calculul ca programul să afișeze Total: 120 lei și Total: 135 lei.
function total(pret: number, transport?: number): number {
return pret + transport ?? 0;
}
console.log(`Total: ${total(120)} lei`);
console.log(`Total: ${total(120, 15)} lei`);Total: 120 lei Total: 135 lei
Indiciu
Valoarea implicită trebuie aplicată doar transportului, nu întregii sume.
Reparația
function total(pret: number, transport?: number): number {
return pret + (transport ?? 0);
}
console.log(`Total: ${total(120)} lei`);
console.log(`Total: ${total(120, 15)} lei`);De ce merge
?? are prioritate mai mică decât +, deci expresia era (pret + transport) ?? 0. O adunare nu dă niciodată undefined (fără transport ar fi dat NaN), așa că ?? 0 nu se folosea niciodată. Cu paranteze, transport ?? 0 dă 0 când transportul lipsește, iar suma e 120, respectiv 135.
Alte forme ale mesajului
error TS2871: This expression is always nullish.
Cum o eviți pe viitor
- Pune mereu paranteze în jurul expresiilor cu
??când apar lângă alți operatori:(a ?? 0) + b. - Folosește
??doar pe valori care chiar pot finullsauundefined(parametri opționali, rezultatul luifind, câmpuri opționale). - Dacă primești mesajul după un upgrade de TypeScript, tratează-l ca pe un bug găsit, nu ca pe o regulă de ocolit.
Întrebări frecvente
De ce nu-mi dădea eroare înainte?
Verificarea a fost adăugată în TypeScript 5.6. Codul era deja greșit, doar că versiunile mai vechi nu-l semnalau. La rulare, pret + undefined dădea NaN, nu valoarea implicită.
E la fel cu TS2872?
Seamănă. TS2872 (This kind of expression is always truthy) apare la ||, && sau într-un if, când partea testată e mereu adevărată. TS2869 e pentru ??, când partea stângă nu e niciodată null/undefined.
Erori înrudite
error TS2872: This kind of expression is always truthy. O condiție sau partea stângă a lui || / && este o valoare care e mereu adevărată (un text nenul, un obiect {}, un tablou []), deci restul nu contează. De obicei ai inversat operanzii: scrie produs.nume || "Fără nume", nu invers. 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 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.
