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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În TypeScript, function f(x: string): string; (cu punct și virgulă, fără acolade) e o semnătură de supraîncărcare: o promisiune că urmează implementarea. Regula e strictă: implementarea trebuie să apară imediat după semnături, cu același nume, fără alt cod între ele.
Primești TS2391 când: ai uitat acoladele și ai pus ; din reflex, ai pus cod între semnături și implementare, ai scris implementarea cu alt nume (o greșeală de tastare) sau ai copiat o declarație dintr-un fișier .d.ts într-un fișier .ts obișnuit.
Linia din mesaj arată semnătura fără corp. Uită-te imediat sub ea: dacă implementarea există mai jos, mut-o lângă semnături; dacă nu există, scrie corpul funcției. Dacă vrei doar să declari o funcție care există în altă parte (de exemplu, furnizată de mediu), folosește declare function.
De ce apare: cauzele frecvente
1Semnătură fără corp
function total(preturi: number[]): number;function total(preturi: number[]): number {
return preturi.reduce((a, b) => a + b, 0);
}Fără acolade, funcția nu are cod. Corpul transformă declarația într-o implementare.
2Cod între semnături și implementare
function f(x: string): string;
function f(x: number): string;
const y = 1;
function f(x: unknown) { return String(x); }function f(x: string): string;
function f(x: number): string;
function f(x: unknown) { return String(x); }
const y = 1;Semnăturile și implementarea trebuie să fie un bloc continuu.
3Nume scris diferit la implementare
function calcul(x: number): number;
function calcl(x: number) { return x; }function calcul(x: number): number;
function calcul(x: number) { return x; }Implementarea trebuie să aibă exact același nume ca semnăturile.
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS2391: Function implementation is missing or not immediately following the declaration. Repară-l ca să afișeze Total coș: 85 lei.
function totalCos(preturi: number[]): number;
const cos = [20, 40, 25];
console.log(`Total coș: ${totalCos(cos)} lei`);Total coș: 85 lei
Indiciu
Funcția are doar semnătură; scrie-i corpul care adună prețurile.
Reparația
function totalCos(preturi: number[]): number {
return preturi.reduce((suma, p) => suma + p, 0);
}
const cos = [20, 40, 25];
console.log(`Total coș: ${totalCos(cos)} lei`);De ce merge
O linie function totalCos(...): number; fără acolade e doar o semnătură, iar TypeScript se aștepta ca implementarea să vină imediat după ea. Nu exista niciun cod care să calculeze totalul. Cu corpul adăugat, funcția devine o implementare obișnuită: reduce adună prețurile pornind de la 0 și dă 85.
Alte forme ale mesajului
error TS2391: Function implementation is missing or not immediately following the declaration.
Cum o eviți pe viitor
- Ține semnăturile de supraîncărcare și implementarea împreună, una sub alta.
- Pentru funcții furnizate de mediu (scripturi externe), folosește
declare function nume(...): tip;. - Dacă nu ai nevoie de mai multe semnături, scrie direct funcția cu corp.
- Când TypeScript raportează mai multe erori pe rând, repară-o întâi pe prima: celelalte sunt adesea efecte ale ei.
Întrebări frecvente
Ce înseamnă „not immediately following”?
Între ultima semnătură și implementare nu are voie să existe altă instrucțiune: nicio variabilă, niciun apel, nicio altă funcție. Doar comentariile sunt permise.
De ce în fișierele .d.ts merge fără corp?
Fișierele .d.ts conțin doar declarații de tipuri: descriu cod care există deja în JavaScript. Într-un .ts, codul trebuie să existe chiar acolo, sau declarația trebuie marcată cu declare.
Erori înrudite
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. 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. 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. Î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.
