...
Eroare TypeScript · Uniuni, tipuri literale și never

error TS2322: Type '"crypto"' is not assignable to type 'never'.

Pe scurt

Ai o verificare exhaustivă (const x: never = valoare în default) și o variantă a uniunii nu e tratată în switch. Mesajul îți spune exact care: adaugă case-ul pentru "crypto". Dacă nu folosești intenționat never, tipul s-a restrâns la nimic din cauza unor verificări contradictorii.

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

Ce înseamnă

never e tipul fără nicio valoare. Într-un switch pe o uniune, după ce ai tratat toate variantele, în default tipul variabilei devine never. Pattern-ul const verificare: never = metoda; profită de asta: dacă ai uitat o variantă, ea „ajunge” în default, iar atribuirea ei la never dă TS2322 cu numele variantei lipsă (aici "crypto").

Deci în acest caz eroarea e utilă și intenționată: cineva a adăugat o variantă nouă în tip, iar compilatorul îți arată toate switch-urile care trebuie actualizate.

Dacă nu ai scris tu niciun never, mesajul poate apărea și când TypeScript a dedus never: o funcție care aruncă mereu, o intersecție imposibilă (string & number), o verificare care a eliminat toate variantele. Pentru tablouri goale tipate never[], vezi eroarea „not assignable to parameter of type 'never'”.

De ce apare: cauzele frecvente

1O variantă nouă netratată în switch

Greșit
TypeScript
type Plata = "card" | "cash" | "crypto";
function comision(p: Plata): number {
  switch (p) {
    case "card": return 2;
    case "cash": return 0;
    default:
      const verificare: never = p;
      return verificare;
  }
}
Corect
TypeScript
type Plata = "card" | "cash" | "crypto";
function comision(p: Plata): number {
  switch (p) {
    case "card": return 2;
    case "cash": return 0;
    case "crypto": return 5;
    default:
      const verificare: never = p;
      return verificare;
  }
}

Cu toate cele trei cazuri tratate, în default nu mai rămâne nicio variantă și atribuirea la never e validă.

2Discriminated union cu un tip uitat

Greșit
TypeScript
type Forma = { tip: "cerc"; r: number } | { tip: "patrat"; l: number };
function arie(f: Forma): number {
  if (f.tip === "cerc") return 3.14 * f.r * f.r;
  const rest: never = f;
  return rest;
}
Corect
TypeScript
type Forma = { tip: "cerc"; r: number } | { tip: "patrat"; l: number };
function arie(f: Forma): number {
  if (f.tip === "cerc") return 3.14 * f.r * f.r;
  if (f.tip === "patrat") return f.l * f.l;
  const rest: never = f;
  return rest;
}

Același mecanism funcționează cu if-uri pe câmpul discriminant.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2322: Type '"easybox"' is not assignable to type 'never', pentru că metoda de livrare nouă nu e tratată în switch. Adaugă cazul easybox cu costul 9 lei, ca programul să afișeze curier: 20 lei, ridicare: 0 lei, easybox: 9 lei.

Codul care dă eroarea
TypeScript
type Livrare = "curier" | "ridicare" | "easybox";
function cost(l: Livrare): number {
  switch (l) {
    case "curier":
      return 20;
    case "ridicare":
      return 0;
    default: {
      const netratat: never = l;
      return netratat;
    }
  }
}
const metode: Livrare[] = ["curier", "ridicare", "easybox"];
console.log(metode.map((m) => `${m}: ${cost(m)} lei`).join(", "));
După reparație, programul afișează
curier: 20 lei, ridicare: 0 lei, easybox: 9 lei
Indiciu

Adaugă un case "easybox" înainte de default.

Alte forme ale mesajului

  • error TS2322: Type '{ tip: "patrat"; l: number; }' is not assignable to type 'never'.
  • error TS2322: Type 'string' is not assignable to type 'never'.

Cum o eviți pe viitor

  • Folosește verificarea exhaustivă cu never în orice switch pe o uniune care se poate extinde: e o plasă de siguranță gratuită.
  • Scrie o funcție ajutătoare function nuTrebuia(x: never): never { throw new Error(Caz netratat: ${x}); } și apeleaz-o în default.
  • Când apare eroarea după o modificare a tipului, tratează varianta nouă, nu șterge verificarea.

Întrebări frecvente

De ce aș vrea intenționat o eroare cu never?

Pentru că transformă „am uitat un caz” dintr-un bug la rulare într-o eroare de compilare, exact în locul unde trebuie adăugat codul.

Pot folosi doar default: return 0 în loc de never?

Poți, dar atunci un caz nou ajunge tăcut în default și primește valoarea 0, fără să afli. Cu never, compilatorul te obligă să decizi.

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.