error TS1241: Unable to resolve signature of method decorator when called as an expression.
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
function log(target: any, cheie: string, d: PropertyDescriptor) {
const original = d.value;
d.value = function (...a: any[]) { return original.apply(this, a); };
}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
{
"compilerOptions": {
"target": "ES2022"
}
}{
"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ă 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.
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));apel aduna 5
Indiciu
Decoratorul standard primește metoda și un ClassMethodDecoratorContext, iar noua metodă o întoarce cu return.
Reparația
function log(original: (...args: any[]) => any, context: ClassMethodDecoratorContext) {
return function (this: unknown, ...args: any[]) {
console.log(`apel ${String(context.name)}`);
return original.apply(this, args);
};
}
class Calculator {
@log
aduna(a: number, b: number) {
return a + b;
}
}
console.log(new Calculator().aduna(2, 3));De ce merge
Decoratorii standard sunt apelați cu două argumente: metoda originală și un obiect context. Forma veche cu descriptor aștepta trei, de aici eroarea. În noua formă, decoratorul întoarce funcția care înlocuiește metoda: ea scrie apel aduna (numele vine din context.name) și apoi apelează metoda originală, care întoarce 5.
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întsconfig.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
error TS2554: Expected 2 arguments, but got 1. Ai apelat o funcție cu alt număr de argumente decât are parametri obligatorii. Trimite toate argumentele cerute sau, dacă unul chiar poate lipsi, fă parametrul opțional (nume?: tip) ori dă-i o valoare implicită. error TS2345: Argument of type 'string' is not assignable to parameter of type 'number'. Ai apelat o funcție cu un argument de alt tip decât cel declarat la parametru: funcția așteaptă number și primește string. Convertește valoarea înainte de apel (Number(...)) sau verifică dacă ai pus argumentele în ordinea corectă. 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.
