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

error TS2367: This comparison appears to be unintentional because the types '"card" | "cash"' and '"Card"' have no overlap.

Pe scurt

Compari două valori ale căror tipuri nu au nimic în comun, deci comparația ar fi mereu falsă (sau mereu adevărată la !==). De obicei e o greșeală de scriere în literal, compari tipuri diferite (number cu string) sau o verificare anterioară a restrâns deja tipul.

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

Ce înseamnă

TypeScript analizează tipurile celor două părți ale lui === / !==. Dacă nu există nicio valoare care să aparțină ambelor tipuri, comparația nu poate fi niciodată adevărată, iar asta e aproape sigur un bug. Mesajul îți spune cele două tipuri: '"card" | "cash"' (ce poate fi variabila) și '"Card"' (cu ce o compari).

Cauze tipice: un literal scris greșit sau cu altă majusculă, compararea unui number cu un string (id === "5"), compararea cu o valoare care nu e în uniune, sau o comparație redundantă după narrowing (de exemplu, într-un else după if (x === "a"), compari iar x === "a").

Repari aducând cele două părți la același tip: corectezi literalul, convertești explicit (Number(id) === 5) sau elimini verificarea care nu mai are sens.

De ce apare: cauzele frecvente

1Literal cu altă majusculă

Greșit
TypeScript
type Plata = "card" | "cash";
function comision(p: Plata) {
  return p === "Card" ? 2 : 0;
}
Corect
TypeScript
type Plata = "card" | "cash";
function comision(p: Plata) {
  return p === "card" ? 2 : 0;
}

"Card" nu e în uniune, deci comparația ar fi mereu falsă.

2number comparat cu string

Greșit
TypeScript
const id: number = 5;
if (id === "5") console.log("găsit");
Corect
TypeScript
const id: number = 5;
if (id === 5) console.log("găsit");

=== nu face conversii, deci un number nu e niciodată egal cu un string.

3Verificare redundantă după narrowing

Greșit
TypeScript
function f(s: "a" | "b") {
  if (s === "a") return 1;
  if (s === "a") return 2;
  return 3;
}
Corect
TypeScript
function f(s: "a" | "b") {
  if (s === "a") return 1;
  if (s === "b") return 2;
  return 3;
}

După primul return, s poate fi doar "b"; a doua verificare a lui "a" nu are sens.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2367: This comparison appears to be unintentional because the types 'Rol' and '"Admin"' have no overlap. Corectează comparația, ca programul să afișeze pe două linii ana: acces complet și dan: acces limitat.

Codul care dă eroarea
TypeScript
type Rol = "admin" | "editor" | "cititor";
function acces(rol: Rol): string {
  return rol === "Admin" ? "acces complet" : "acces limitat";
}
console.log(`ana: ${acces("admin")}`);
console.log(`dan: ${acces("cititor")}`);
După reparație, programul afișează
ana: acces complet
dan: acces limitat
Indiciu

Valorile din tipul Rol sunt scrise cu literă mică.

Alte forme ale mesajului

  • error TS2367: This comparison appears to be unintentional because the types 'number' and 'string' have no overlap.

Cum o eviți pe viitor

  • Folosește tipuri literale pentru seturi fixe de valori și autocomplete la comparații.
  • Convertește datele din exterior la tipul corect o singură dată, la intrare, ca să compari mereu number cu number.
  • Pentru uniuni, preferă switch cu toate cazurile; TypeScript te avertizează la cazuri imposibile.

Întrebări frecvente

De ce în JavaScript 5 == "5" e adevărat, iar aici primesc eroare?

== face conversii de tip, === nu. Oricum, TypeScript semnalează ambele forme când tipurile nu se suprapun, pentru că de obicei e o greșeală.

Și dacă vreau intenționat să verific o valoare care „n-ar trebui” să apară?

Lărgește tipul în locul acela (de exemplu primește string, nu uniunea) sau folosește o verificare exhaustivă cu never în default.

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.