...
Eroare JavaScript · Erori de sintaxă (SyntaxError)

SyntaxError: Class constructor may not be an async method

Pe scurt

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

Greșit
JavaScript
class Utilizator {
  async constructor(id) {
    this.date = await incarca(id);
  }
}
Corect
JavaScript
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

Greșit
JavaScript
class Produs {
  get constructor() { return 1; }
}
Corect
JavaScript
class Produs {
  constructor() { this.cod = 1; }
}

Constructorul e o metodă normală; nu poate fi accesor.

3Constructor generator

Greșit
JavaScript
class Lista {
  *constructor() { yield 1; }
}
Corect
JavaScript
class Lista {
  *[Symbol.iterator]() { yield 1; }
}

Dacă vrei un obiect parcurgibil, generatorul se pune pe Symbol.iterator, nu pe constructor.

Repară tu

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

Codul care dă eroarea
JavaScript
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();
După reparație, programul afișează
Salut, Ana!
Indiciu

Metoda statică face await incarcaProfil(id) și întoarce new Utilizator(profil).

Alte forme ale mesajului

  • SyntaxError: Class constructor may not be an accessor
  • SyntaxError: Class constructor may not be a generator
  • SyntaxError: 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 cu new.

Î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

← Toate erorile JavaScript

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ță 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.