...
Eroare TypeScript · Mediu, biblioteci și module

error TS1183: An implementation cannot be declared in ambient contexts.

Pe scurt

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

Greșit
TypeScript
declare function formateaza(suma: number): string {
  return suma.toFixed(2) + ' lei';
}
Corect
TypeScript
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

Greșit
TypeScript
// utilitare.d.ts
export function suma(a: number, b: number) {
  return a + b;
}
Corect
TypeScript
// 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

Greșit
TypeScript
declare class Logger {
  log(m: string) { console.log(m); }
}
Corect
TypeScript
declare class Logger {
  log(m: string): void;
}

declare class descrie o clasă creată de alt cod. Metodele au doar semnătură.

Repară tu

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.

Codul care dă eroarea
TypeScript
declare function formateaza(suma: number): string {
  return suma.toFixed(2) + ' lei';
}

console.log(formateaza(12.5));
console.log(formateaza(3));
După reparație, programul afișează
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.

Alte forme ale mesajului

  • error TS1039: Initializers are not allowed in ambient contexts.

Cum o eviți pe viitor

  • Folosește declare doar 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

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