...
Eroare TypeScript · Funcții, apeluri și async

error TS2677: A type predicate's type must be assignable to its parameter's type.

Pe scurt

Un type guard (x is Tip) poate doar să restrângă tipul parametrului, nu să-l schimbe în ceva fără legătură. Dacă parametrul e string, nu poți spune x is number. Lărgește tipul parametrului (unknown, o uniune) sau corectează tipul din predicat.

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

Ce înseamnă

O funcție de tip function e(x: A): x is B promite: „dacă întorc true, atunci x e de fapt un B”. Asta are sens doar dacă B e un caz particular al lui A (un subtip). Dacă B nu se potrivește deloc cu A, promisiunea e imposibilă și TypeScript raportează TS2677, adesea cu detaliul Type 'number' is not assignable to type 'string'.

Apare când parametrul are un tip prea strict (x: string cu x is number), când ai greșit numele tipului în predicat, sau când predicatul cere un câmp care nu există în tipul parametrului (p: Produs cu p is Client).

Reparația: parametrul unui type guard ar trebui să fie tipul larg (unknown, o uniune Produs | Client), iar predicatul, unul dintre cazurile lui.

De ce apare: cauzele frecvente

1Parametru prea strict pentru predicat

Greșit
TypeScript
function esteNumar(x: string): x is number {
  return !isNaN(Number(x));
}
Corect
TypeScript
function esteNumar(x: unknown): x is number {
  return typeof x === 'number';
}

Un string nu poate deveni number; cu unknown, number e un caz posibil.

2Tipuri fără legătură

Greșit
TypeScript
interface Produs { pret: number }
interface Client { email: string }
function esteClient(x: Produs): x is Client {
  return 'email' in x;
}
Corect
TypeScript
interface Produs { pret: number }
interface Client { email: string }
function esteClient(x: Produs | Client): x is Client {
  return 'email' in x;
}

Parametrul trebuie să includă tipul din predicat; uniunea îl include.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2677: A type predicate's type must be assignable to its parameter's type. Type guard-ul separă plățile cu card de cele cash. Repară tipul parametrului ca programul să afișeze Card: 2, total card: 150 lei.

Codul care dă eroarea
TypeScript
interface Card { tip: 'card'; suma: number; ultimele4: string }
interface Cash { tip: 'cash'; suma: number }
type Plata = Card | Cash;
function eCard(p: Cash): p is Card {
  return p.tip === 'card';
}
const plati: Plata[] = [
  { tip: 'card', suma: 100, ultimele4: '1234' },
  { tip: 'cash', suma: 20 },
  { tip: 'card', suma: 50, ultimele4: '9876' },
];
const carduri = plati.filter(eCard);
const total = carduri.reduce((s, p) => s + p.suma, 0);
console.log(`Card: ${carduri.length}, total card: ${total} lei`);
După reparație, programul afișează
Card: 2, total card: 150 lei
Indiciu

Parametrul trebuie să poată fi orice fel de plată, nu doar cash.

Cum o eviți pe viitor

  • Dă parametrului unui type guard tipul cel mai larg pe care îl primești: unknown sau uniunea completă.
  • Verifică în corp exact ce promite predicatul; TypeScript nu verifică logica, doar tipurile.
  • Dacă vrei de fapt o conversie (text în număr), scrie o funcție care întoarce noul tip, nu un type guard.

Întrebări frecvente

De ce nu pot face un type guard care transformă un string în număr?

Un type guard nu schimbă valoarea, doar spune ce este ea deja. Un text rămâne text. Pentru conversie, întoarce valoarea nouă: function caNumar(x: string): number | null.

TypeScript verifică dacă logica din type guard e corectă?

Nu. Poți întoarce true greșit și TypeScript te crede. De aceea type guard-urile trebuie scrise atent și testate.

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.