SyntaxError: Class constructor may not be an async method
Constructorul unei clase nu poate fi async (și nici getter sau generator): new trebuie să întoarcă imediat obiectul, nu o promisiune. Mută partea asincronă într-o metodă statică de tip fabrică, de exemplu static async creeaza(id), care face await și apoi întoarce new Clasa(date).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când scrii new Utilizator(7), JavaScript creează obiectul, rulează constructorul și îți dă obiectul imediat. O funcție async întoarce însă mereu o promisiune, deci un constructor async ar contrazice regula lui new. De aceea parserul refuză din start async constructor().
Aceeași familie de mesaje apare pentru alte forme speciale: get constructor() dă Class constructor may not be an accessor, iar *constructor() dă Class constructor may not be a generator.
Situația tipică: vrei ca obiectul să se încarce dintr-un API sau dintr-o bază de date chiar la creare. Soluția standard e o metodă statică fabrică: static async creeaza(id) face await pe date, apoi apelează constructorul sincron cu datele gata încărcate. Apelul devine const u = await Utilizator.creeaza(7).
Alternativ, constructorul rămâne sincron și oferi o metodă separată async incarca(), pe care o apelezi după creare.
De ce apare: cauzele frecvente
1Constructor async ca să încarce date
class Utilizator {
async constructor(id) {
this.date = await incarca(id);
}
}class Utilizator {
constructor(date) { this.date = date; }
static async creeaza(id) {
return new Utilizator(await incarca(id));
}
}Fabrica statică poate fi async, iar constructorul rămâne sincron, cum cere new.
2Constructor declarat ca getter
class Produs {
get constructor() { return 1; }
}class Produs {
constructor() { this.cod = 1; }
}Constructorul e o metodă normală; nu poate fi accesor.
3Constructor generator
class Lista {
*constructor() { yield 1; }
}class Lista {
*[Symbol.iterator]() { yield 1; }
}Dacă vrei un obiect parcurgibil, generatorul se pune pe Symbol.iterator, nu pe constructor.
Repară eroarea, direct în pagină
Clasa Utilizator încearcă să-și încarce profilul direct în constructor, cu async constructor, iar programul nu pornește: SyntaxError: Class constructor may not be an async method. Rescrie clasa cu un constructor sincron și o metodă statică creeaza(id), ca programul să afișeze Salut, Ana!.
function incarcaProfil(id) {
return Promise.resolve({ id, nume: "Ana" });
}
class Utilizator {
async constructor(id) {
const profil = await incarcaProfil(id);
this.nume = profil.nume;
}
}
async function main() {
const u = await new Utilizator(7);
console.log(`Salut, ${u.nume}!`);
}
main();Salut, Ana!
Indiciu
Metoda statică face await incarcaProfil(id) și întoarce new Utilizator(profil).
Reparația
function incarcaProfil(id) {
return Promise.resolve({ id, nume: "Ana" });
}
class Utilizator {
constructor(profil) {
this.nume = profil.nume;
}
static async creeaza(id) {
const profil = await incarcaProfil(id);
return new Utilizator(profil);
}
}
async function main() {
const u = await Utilizator.creeaza(7);
console.log(`Salut, ${u.nume}!`);
}
main();De ce merge
new trebuie să întoarcă imediat instanța, așa că un constructor async, care ar întoarce o promisiune, e interzis de limbaj. Metoda statică creeaza poate fi async: așteaptă profilul, apoi apelează constructorul sincron cu datele deja încărcate. În main, await Utilizator.creeaza(7) primește un utilizator complet, cu nume setat.
Alte forme ale mesajului
SyntaxError: Class constructor may not be an accessorSyntaxError: Class constructor may not be a generatorSyntaxError: Class constructor may not be an async method (at app.js:2:9)
Cum o eviți pe viitor
- Păstrează constructorii scurți și sincroni: doar atribuie câmpuri.
- Pentru încărcări din rețea, fișiere sau baze de date, folosește
static async creeaza(...). - Nu pune
awaitîn constructor; dacă îți vine să o faci, e semn că ai nevoie de fabrică. - Documentează în cod că obiectul se creează cu
await Clasa.creeaza(), nu cunew.
Întrebări frecvente
Pot face return promisiune din constructor?
Tehnic, un constructor poate întoarce un obiect, inclusiv o promisiune, dar atunci new îți dă promisiunea în loc de instanță, iar instanceof nu mai merge. E derutant; folosește fabrica statică.
Fabrica statică merge și cu moștenire?
Da. Într-o clasă copil poți suprascrie static async creeaza() sau poți folosi new this(date) în fabrica părinte, ca să creeze instanța clasei pe care ai apelat-o.
Erori înrudite
SyntaxError: await is only valid in async functions and the top level bodies of modules Ai folosit `await` într-o funcție care nu e marcată `async` (des: într-un callback de `forEach` sau `map`) sau la nivelul de sus al unui script care nu e modul. Adaugă `async` funcției care conține `await`, sau pune codul într-o funcție `async function main() { ... }` și apeleaz-o. SyntaxError: A class may only have one constructor Ai scris două metode `constructor` în aceeași clasă, de obicei ca să ai „supraîncărcare” ca în Java sau C#. JavaScript permite un singur constructor. Păstrează unul și tratează variantele cu parametri impliciți sau cu metode statice de fabricare. Uncaught (in promise) Error: Request failed O promisiune a fost respinsă (o funcție `async` a aruncat o eroare sau o cerere a eșuat), iar nimeni nu a prins eroarea cu `try...catch` sau `.catch()`. Pune `await` în interiorul unui `try...catch`, sau adaugă `.catch()` la apelul funcției `async`. Învață JavaScript de la zero, cu exerciții la fiecare lecție
Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
