error TS2677: A type predicate's type must be assignable to its parameter's type.
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
function esteNumar(x: string): x is number {
return !isNaN(Number(x));
}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ă
interface Produs { pret: number }
interface Client { email: string }
function esteClient(x: Produs): x is Client {
return 'email' in x;
}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ă 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.
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`);Card: 2, total card: 150 lei
Indiciu
Parametrul trebuie să poată fi orice fel de plată, nu doar cash.
Reparația
interface Card { tip: 'card'; suma: number; ultimele4: string }
interface Cash { tip: 'cash'; suma: number }
type Plata = Card | Cash;
function eCard(p: Plata): 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`);De ce merge
Predicatul p is Card spune că p e de fapt un Card. Dacă parametrul e Cash, promisiunea e imposibilă: un Cash nu poate fi Card. Cu parametrul de tip Plata (uniunea), Card e unul dintre cazuri, iar filter(eCard) întoarce un Card[]: două plăți, 100 + 50 = 150 lei.
Cum o eviți pe viitor
- Dă parametrului unui type guard tipul cel mai larg pe care îl primești:
unknownsau 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
error TS18046: 'e' is of type 'unknown'. Variabila are tipul unknown (des: eroarea din catch, rezultatul lui JSON.parse tipat ca unknown) și nu poți folosi nimic pe ea până nu verifici ce este. Fă narrowing, de exemplu if (e instanceof Error) console.log(e.message). error TS2339: Property 'toUpperCase' does not exist on type 'string | number'. Variabila are un tip uniune (string | number), iar metoda există doar pe una dintre variante. Fă narrowing înainte: if (typeof x === "string") x.toUpperCase(); în ramura aceea TypeScript știe că e string. error TS2322: Type 'string' is not assignable to type 'number'. Ai pus un text (string) într-o variabilă, un câmp sau un rezultat declarat ca number. Repari convertind textul în număr cu Number() sau parseFloat(), ori schimbând tipul declarat dacă valoarea chiar trebuie să fie text. Î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.
