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

error TS2869: Right operand of ?? is unreachable because the left operand is never nullish.

Pe scurt

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

Greșit
TypeScript
function total(pret: number, transport?: number) {
  return pret + transport ?? 0;
}
Corect
TypeScript
function total(pret: number, transport?: number) {
  return pret + (transport ?? 0);
}

Parantezele aplică ?? doar lui transport, care chiar poate fi undefined.

2Comparație înainte de ??

Greșit
TypeScript
function areStoc(stoc?: number) {
  return stoc > 0 ?? false;
}
Corect
TypeScript
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ă

Greșit
TypeScript
const titlu = `Comanda ${'x'}` ?? 'fără titlu';
Corect
TypeScript
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ă tu

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.

Codul care dă eroarea
TypeScript
function total(pret: number, transport?: number): number {
  return pret + transport ?? 0;
}
console.log(`Total: ${total(120)} lei`);
console.log(`Total: ${total(120, 15)} lei`);
După reparație, programul afișează
Total: 120 lei
Total: 135 lei
Indiciu

Valoarea implicită trebuie aplicată doar transportului, nu întregii sume.

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 fi null sau undefined (parametri opționali, rezultatul lui find, 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

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