...
Eroare TypeScript · Clase și interfețe implementate

error TS1241: Unable to resolve signature of method decorator when called as an expression.

Pe scurt

Decoratorul are forma veche (target, cheie, descriptor), dar proiectul folosește decoratorii standard din TypeScript 5+, care primesc (metoda, context). Rescrie decoratorul cu semnătura nouă sau, într-un proiect vechi (Angular, NestJS), activează experimentalDecorators în tsconfig.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Există două sisteme de decoratori. Cel vechi („experimental”), folosit ani de zile de Angular, NestJS sau TypeORM, apelează un decorator de metodă cu trei argumente: (target, propertyKey, descriptor). Cel standard (ECMAScript), activ implicit din TypeScript 5.0 când experimentalDecorators nu e pornit, îl apelează cu două: (metoda, context).

TS1241 apare când decoratorul e scris pentru un sistem, iar compilatorul folosește celălalt. Mesajul are de obicei și o a doua linie care spune exact nepotrivirea, de exemplu The runtime will invoke the decorator with 2 arguments, but the decorator expects 3.

Ai două reparații: rescrii decoratorul în forma standard (function log(original, context: ClassMethodDecoratorContext), care întoarce noua metodă), sau, dacă biblioteca ta cere forma veche, pui "experimentalDecorators": true în tsconfig.json. Pentru clase, proprietăți și parametri există variante cu același mesaj (TS1238, TS1240, TS1239).

De ce apare: cauzele frecvente

1Decorator vechi, compilat cu decoratorii standard

Greșit
TypeScript
function log(target: any, cheie: string, d: PropertyDescriptor) {
  const original = d.value;
  d.value = function (...a: any[]) { return original.apply(this, a); };
}
Corect
TypeScript
function log(original: (...a: any[]) => any, context: ClassMethodDecoratorContext) {
  return function (this: unknown, ...a: any[]) {
    return original.apply(this, a);
  };
}

Decoratorul standard primește metoda și un obiect context, iar înlocuirea se face prin valoarea întoarsă, nu prin descriptor.

2Proiect care chiar folosește decoratorii vechi

Greșit
TypeScript
{
  "compilerOptions": {
    "target": "ES2022"
  }
}
Corect
TypeScript
{
  "compilerOptions": {
    "target": "ES2022",
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true
  }
}

Angular, NestJS și TypeORM folosesc încă decoratorii experimentali. Cu opțiunea activată, semnătura cu trei argumente e cea corectă.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS1241: Unable to resolve signature of method decorator when called as an expression. Decoratorul log e scris în forma veche, dar editorul folosește decoratorii standard. Rescrie-l în forma (original, context) ca programul să afișeze apel aduna și apoi 5.

Codul care dă eroarea
TypeScript
function log(target: any, cheie: string, descriptor: PropertyDescriptor) {
  const original = descriptor.value;
  descriptor.value = function (...args: any[]) {
    console.log(`apel ${cheie}`);
    return original.apply(this, args);
  };
}

class Calculator {
  @log
  aduna(a: number, b: number) {
    return a + b;
  }
}

console.log(new Calculator().aduna(2, 3));
După reparație, programul afișează
apel aduna
5
Indiciu

Decoratorul standard primește metoda și un ClassMethodDecoratorContext, iar noua metodă o întoarce cu return.

Alte forme ale mesajului

  • error TS1238: Unable to resolve signature of class decorator when called as an expression.
  • error TS1240: Unable to resolve signature of property decorator when called as an expression.
  • error TS1239: Unable to resolve signature of parameter decorator when called as an expression.

Cum o eviți pe viitor

  • Află ce sistem de decoratori folosește proiectul: caută experimentalDecorators în tsconfig.json.
  • Când copiezi un decorator dintr-un tutorial, verifică forma: trei argumente (vechi) sau (valoare, context) (standard).
  • În proiecte noi, fără framework care cere forma veche, folosește decoratorii standard.
  • Citește a doua linie a erorii: îți spune câte argumente primește decoratorul la rulare.

Întrebări frecvente

De ce codul mergea înainte și acum dă eroare?

Probabil a fost scos experimentalDecorators din tsconfig.json sau proiectul a fost mutat pe o configurație nouă. Din TypeScript 5.0, fără acea opțiune se folosesc decoratorii standard, care au altă semnătură.

Pot folosi decoratori de parametri cu sistemul standard?

Nu. Decoratorii de parametri (constructor(@Inject() x)) există doar în sistemul experimental. Dacă framework-ul tău îi folosește, ai nevoie de experimentalDecorators: true.

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.