...
Eroare JavaScript · Promisiuni și async/await

TypeError: Promise constructor cannot be invoked without 'new'

Pe scurt

Ai scris Promise((resolve) => ...) fără new. O promisiune nouă se creează doar cu new Promise((resolve, reject) => ...). Dacă vrei doar o promisiune deja rezolvată, folosește Promise.resolve(valoare).

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

Ce înseamnă

Promise este un constructor: o promisiune nouă se creează cu new Promise(executor), unde executor e funcția care primește resolve și reject. Apelat ca funcție obișnuită, Promise(...) aruncă imediat Promise constructor cannot be invoked without 'new'.

Confuzia apare pentru că metodele statice se folosesc fără new: Promise.resolve(x), Promise.reject(e), Promise.all([...]), Promise.withResolvers(). Mulți le amestecă și scriu Promise((resolve) => ...) sau return Promise(...) în funcții care „promisifică” un callback.

Ai trei variante corecte, după caz:

  • new Promise((resolve, reject) => {...}) când transformi un callback sau un setTimeout în promisiune;
  • Promise.resolve(valoare) pentru o valoare deja cunoscută;
  • o funcție async, care întoarce automat o promisiune, fără niciun constructor.

De ce apare: cauzele frecvente

1Întârziere scrisă fără new

Greșit
JavaScript
const asteapta = (ms) => Promise((resolve) => setTimeout(resolve, ms));
Corect
JavaScript
const asteapta = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

Executorul e rulat doar de constructor, apelat cu new.

2Promisiune pentru o valoare cunoscută

Greșit
JavaScript
function citesteCache() {
  return Promise((resolve) => resolve(cache));
}
Corect
JavaScript
function citesteCache() {
  return Promise.resolve(cache);
}

Pentru o valoare deja disponibilă, Promise.resolve e mai scurt și nu cere new.

3Funcție async în loc de constructor

Greșit
JavaScript
const totalAsync = (a, b) => Promise((r) => r(a + b));
Corect
JavaScript
const totalAsync = async (a, b) => a + b;

O funcție async întoarce mereu o promisiune cu valoarea din return.

Repară tu

Repară eroarea, direct în pagină

Funcția asteapta trebuie să întoarcă o promisiune care se rezolvă după un număr de milisecunde, dar codul dă TypeError: Promise constructor cannot be invoked without 'new'. Repară funcția ca programul să afișeze Început, apoi Gata după 50 ms.

Codul care dă eroarea
JavaScript
function asteapta(ms) {
  return Promise((resolve) => setTimeout(() => resolve(ms), ms));
}

console.log("Început");
asteapta(50).then((ms) => console.log(`Gata după ${ms} ms`));
După reparație, programul afișează
Început
Gata după 50 ms
Indiciu

Promisiunea se creează cu new Promise((resolve) => ...).

Alte forme ale mesajului

  • Uncaught TypeError: Promise constructor cannot be invoked without 'new'
  • TypeError: calling a builtin Promise constructor without new is forbidden
  • TypeError: Promise constructor cannot be invoked without 'new' at Promise (<anonymous>)

Cum o eviți pe viitor

  • Memorează forma completă: new Promise((resolve, reject) => { ... }).
  • Folosește new Promise doar pentru a transforma API-uri cu callback; în rest, preferă funcțiile async.
  • Pentru valori gata calculate, Promise.resolve/Promise.reject.
  • ESLint (no-promise-executor-return, prefer-promise-reject-errors) te ajută să scrii executorii corect.

Întrebări frecvente

De ce Promise.resolve merge fără new?

Pentru că e o metodă statică a clasei, nu constructorul. Intern, ea creează promisiunea cu constructorul pentru tine.

E la fel cu „Promise resolver undefined is not a function”?

Nu. Aceea apare când scrii new Promise() fără funcția executor. Aici ai executorul, dar lipsește new.

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.