error TS2394: This overload signature is not compatible with its implementation signature.
Una dintre semnăturile de supraîncărcare (overload) are parametri sau tip de retur pe care implementarea nu le acceptă. Lărgește semnătura implementării (de exemplu string | number) ca să le cuprindă pe toate.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
La supraîncărcări scrii mai multe semnături fără corp și, la final, o singură implementare. Semnăturile sunt ce vede cine apelează; implementarea trebuie să poată primi orice combinație permisă de ele. Dacă o semnătură acceptă number, iar implementarea are parametrul string, implementarea nu ar putea trata acel apel, așa că primești TS2394.
Mesajul e pus pe semnătura incompatibilă (linia ei), nu pe implementare. Compară-le parametru cu parametru: tipurile, numărul de parametri, opționalitatea și tipul de retur. Implementarea are de obicei tipuri mai largi: uniuni (string | number), parametri opționali, unknown.
Apare des când adaugi o semnătură nouă la o funcție existentă și uiți să actualizezi implementarea.
De ce apare: cauzele frecvente
1Implementarea nu acceptă tipul din semnătură
function format(x: string): string;
function format(x: number): string;
function format(x: string): string {
return x;
}function format(x: string): string;
function format(x: number): string;
function format(x: string | number): string {
return String(x);
}Implementarea trebuie să accepte uniunea tuturor tipurilor din semnături.
2Număr diferit de parametri
function pret(b: number): number;
function pret(b: number, tva: number): number;
function pret(b: number): number { return b; }function pret(b: number): number;
function pret(b: number, tva: number): number;
function pret(b: number, tva = 0): number { return b * (1 + tva); }Un parametru opțional (sau cu valoare implicită) în implementare acoperă ambele semnături.
3Tip de retur incompatibil
function id(x: string): string;
function id(x: number): number;
function id(x: string | number): string { return String(x); }function id(x: string): string;
function id(x: number): number;
function id(x: string | number): string | number { return x; }Implementarea trebuie să poată întoarce și tipul cerut de fiecare semnătură.
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS2394: This overload signature is not compatible with its implementation signature. Repară implementarea ca programul să afișeze 150 lei și 150 lei.
function formateaza(suma: number): string;
function formateaza(suma: string): string;
function formateaza(suma: number): string {
return `${suma} lei`;
}
console.log(formateaza(150));
console.log(formateaza('150'));150 lei 150 lei
Indiciu
Implementarea trebuie să accepte și numere, și texte.
Reparația
function formateaza(suma: number): string;
function formateaza(suma: string): string;
function formateaza(suma: number | string): string {
return `${Number(suma)} lei`;
}
console.log(formateaza(150));
console.log(formateaza('150'));De ce merge
Semnătura formateaza(suma: string) promite că funcția acceptă text, dar implementarea primea doar number. Un apel cu '150' n-ar fi avut cod care să-l trateze, așa că TypeScript a marcat semnătura ca incompatibilă. Cu number | string, implementarea acoperă ambele semnături, iar Number(suma) aduce valoarea la același format.
Cum o eviți pe viitor
- Scrie întâi implementarea cu tipuri largi (uniuni, opționali), apoi semnăturile mai precise deasupra.
- Când adaugi o semnătură, actualizează imediat și implementarea.
- Întreabă-te dacă ai nevoie de overload-uri: de multe ori un singur tip cu uniune sau un generic e mai simplu.
Întrebări frecvente
Implementarea se poate apela direct?
Nu. Din afară se văd doar semnăturile de deasupra. Semnătura implementării e doar pentru corpul funcției, de aceea poate fi mai largă.
Ce diferență e față de TS2769?
TS2769 (No overload matches this call) apare la apel, când argumentele nu se potrivesc cu nicio semnătură. TS2394 apare la definiție, când semnăturile și implementarea nu se potrivesc între ele.
Erori înrudite
error TS2769: No overload matches this call. Funcția apelată are mai multe semnături (overload-uri) și argumentele tale nu se potrivesc cu niciuna. Citește partea a doua a mesajului („Overload 1 of 2... gave the following error”): acolo e argumentul greșit, de obicei un tip diferit de cel cerut. error TS2391: Function implementation is missing or not immediately following the declaration. Ai scris o semnătură de funcție fără corp (fără { ... }), iar implementarea lipsește sau nu e imediat după. Adaugă corpul funcției sau pune implementarea direct sub semnăturile de supraîncărcare. error TS2393: Duplicate function implementation. Ai două funcții cu același nume și corp în același domeniu (sau în două fișiere script). Șterge una, redenumește-o, sau, dacă voiai supraîncărcare, scrie semnăturile fără corp și o singură implementare. Î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.
