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

error TS2394: This overload signature is not compatible with its implementation signature.

Pe scurt

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ă

Greșit
TypeScript
function format(x: string): string;
function format(x: number): string;
function format(x: string): string {
  return x;
}
Corect
TypeScript
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

Greșit
TypeScript
function pret(b: number): number;
function pret(b: number, tva: number): number;
function pret(b: number): number { return b; }
Corect
TypeScript
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

Greșit
TypeScript
function id(x: string): string;
function id(x: number): number;
function id(x: string | number): string { return String(x); }
Corect
TypeScript
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ă tu

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.

Codul care dă eroarea
TypeScript
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'));
După reparație, programul afișează
150 lei
150 lei
Indiciu

Implementarea trebuie să accepte și numere, și texte.

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

← 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.