error TS1183: An implementation cannot be declared in ambient contexts.
Ai scris cod cu corp într-o declarație cu declare sau într-un fișier .d.ts. declare doar descrie ceva care există deja; nu poate conține implementare. Scoate declare dacă vrei să scrii funcția, sau scoate corpul dacă doar o descrii.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un context ambient e locul unde descrii tipuri pentru cod care există în altă parte: tot ce e marcat cu declare (declare function, declare class, declare module, declare global) și orice fișier .d.ts. Acolo TypeScript nu generează JavaScript, deci nu poate exista corp de funcție sau de metodă.
TS1183 apare când scrii totuși o implementare: declare function f() { ... }, o metodă cu corp într-o declare class, sau cod real într-un fișier .d.ts. Ruda lui e TS1039 (Initializers are not allowed in ambient contexts), pentru valori inițiale: declare let x: number = 5.
Decide ce voiai: dacă scrii cod care trebuie să ruleze, scoate declare (sau mută codul din .d.ts într-un .ts). Dacă doar descrii o funcție dintr-o bibliotecă, păstrează semnătura și scoate corpul.
De ce apare: cauzele frecvente
1declare în fața unei funcții scrise de tine
declare function formateaza(suma: number): string {
return suma.toFixed(2) + ' lei';
}function formateaza(suma: number): string {
return suma.toFixed(2) + ' lei';
}Funcția e implementată aici, deci nu e ambientală. Fără declare e o funcție normală.
2Cod real într-un fișier .d.ts
// utilitare.d.ts
export function suma(a: number, b: number) {
return a + b;
}// utilitare.d.ts
export function suma(a: number, b: number): number;Fișierele .d.ts conțin doar tipuri. Implementarea stă într-un .ts sau .js separat.
3Metodă cu corp într-o declare class
declare class Logger {
log(m: string) { console.log(m); }
}declare class Logger {
log(m: string): void;
}declare class descrie o clasă creată de alt cod. Metodele au doar semnătură.
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS1183: An implementation cannot be declared in ambient contexts. Funcția formateaza e scrisă chiar aici și trebuie să ruleze. Repar-o ca programul să afișeze 12.50 lei și apoi 3.00 lei.
declare function formateaza(suma: number): string {
return suma.toFixed(2) + ' lei';
}
console.log(formateaza(12.5));
console.log(formateaza(3));12.50 lei 3.00 lei
Indiciu
Cuvântul din fața lui function spune că funcția există în altă parte, ceea ce nu e adevărat aici.
Reparația
function formateaza(suma: number): string {
return suma.toFixed(2) + ' lei';
}
console.log(formateaza(12.5));
console.log(formateaza(3));De ce merge
declare descrie o funcție care există deja în alt cod, deci nu poate avea corp. Aici funcția e implementată în fișier, așa că trebuie declarată normal, fără declare. Acum TypeScript generează codul ei, iar apelurile afișează 12.50 lei și 3.00 lei.
Alte forme ale mesajului
error TS1039: Initializers are not allowed in ambient contexts.
Cum o eviți pe viitor
- Folosește
declaredoar pentru lucruri create în afara codului tău TypeScript: scripturi externe, variabile globale, biblioteci fără tipuri. - Ține implementările în
.tsși tipurile scrise de mână în.d.ts. - Dacă ai nevoie de tipuri pentru o bibliotecă JavaScript, caută întâi pachetul
@types/...înainte să scrii propriile declarații.
Întrebări frecvente
Ce înseamnă „ambient”?
Că declarația descrie ceva care există deja la rulare, creat de alt cod. TypeScript o folosește doar la verificare și nu generează nimic pentru ea în JavaScript.
De ce declare const x = 5 merge, dar declare let x: number = 5 nu?
La declare const TypeScript acceptă un literal simplu ca tip (5), fiind doar o descriere a valorii. La let sau cu adnotare de tip, valoarea ar fi o inițializare reală, care nu are loc în context ambient, deci primești TS1039.
Erori înrudite
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 TS2669: Augmentations for the global scope can only be directly nested in external modules or ambient module declarations. Ai scris declare global { ... } într-un fișier care nu e modul (nu are niciun import sau export). Adaugă export {}; în fișier ca să devină modul, sau, într-un script, scoate wrapper-ul și scrie direct declare var nume: Tip;. error TS2307: Cannot find module 'lodash' or its corresponding type declarations. TypeScript nu găsește modulul importat: pachetul nu e instalat, nu are tipuri, calea relativă e greșită sau rulezi într-un mediu fără module. Instalează pachetul (și @types/<pachet> dacă e nevoie), corectează calea sau, într-un singur fișier, scrie funcția local. Î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.
