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

TypeError: Chaining cycle detected for promise #<Promise>

Pe scurt

O promisiune a fost rezolvată cu ea însăși: în then-ul ei ai făcut return chiar promisiunea pe care o creează then (sau un async a întors propria promisiune). Ar aștepta la nesfârșit, așa că JavaScript o respinge. Întoarce valoarea (datele), nu promisiunea.

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

Ce înseamnă

Când un callback din .then(...) întoarce o promisiune, promisiunea creată de then o „adoptă”: așteaptă după ea și preia rezultatul. Dacă întorci chiar promisiunea creată de acel then, ea ar trebui să se aștepte pe ea însăși, la nesfârșit. Specificația detectează cazul și respinge promisiunea cu TypeError: Chaining cycle detected for promise #<Promise>.

Cum ajungi aici în practică:

  • salvezi rezultatul lui then într-o variabilă (const incarcare = ...then(...)) și, din reflex, faci return incarcare în callback;
  • o logică de cache care întoarce promisiunea din cache chiar în timp ce o rezolvă;
  • un resolve(p) în constructorul new Promise, unde p e chiar promisiunea creată.

Eroarea apare de obicei ca Uncaught (in promise) TypeError: Chaining cycle detected..., pentru că nimeni nu tratează respingerea. Caută return în callback-urile then și verifică ce variabilă întorci.

De ce apare: cauzele frecvente

1then întoarce propria promisiune

Greșit
JavaScript
const incarcare = cerere().then((r) => {
  cache.produse = r.date;
  return incarcare;
});
Corect
JavaScript
const incarcare = cerere().then((r) => {
  cache.produse = r.date;
  return r.date;
});

Callback-ul trebuie să dea valoarea, iar incarcare se rezolvă cu ea.

2resolve cu promisiunea însăși

Greșit
JavaScript
const p = new Promise((resolve) => {
  setTimeout(() => resolve(p), 10);
});
Corect
JavaScript
const p = new Promise((resolve) => {
  setTimeout(() => resolve("gata"), 10);
});

resolve primește rezultatul, nu promisiunea pe care o rezolvă.

3Funcție async care întoarce promisiunea din cache în timp ce o creează

Greșit
JavaScript
let cache;
function ia() {
  cache = cerere().then(() => cache);
  return cache;
}
Corect
JavaScript
let cache;
function ia() {
  cache ??= cerere().then((r) => r.date);
  return cache;
}

Cache-ul păstrează promisiunea, dar callback-ul ei întoarce datele.

Repară tu

Repară eroarea, direct în pagină

Programul încarcă produsele, le salvează în cache și vrea să afișeze câte sunt, dar se oprește cu TypeError: Chaining cycle detected for promise #<Promise>. Repară callback-ul din then ca programul să afișeze Produse: 2.

Codul care dă eroarea
JavaScript
function cerereSimulata() {
  return Promise.resolve({ ok: true, date: ["cană", "lampă"] });
}

const cache = {};

const incarcare = cerereSimulata().then((r) => {
  cache.produse = r.date;
  return incarcare;
});

incarcare.then((produse) => {
  console.log(`Produse: ${produse.length}`);
});
După reparație, programul afișează
Produse: 2
Indiciu

Callback-ul trebuie să întoarcă lista de produse, nu promisiunea incarcare.

Alte forme ale mesajului

  • Uncaught (in promise) TypeError: Chaining cycle detected for promise #<Promise>
  • TypeError: A promise cannot be resolved with itself.

Cum o eviți pe viitor

  • În then, întoarce date sau altă promisiune, niciodată variabila în care salvezi rezultatul lui then.
  • Preferă async/await: const r = await cerere(); return r.date; face fluxul liniar și greu de încurcat.
  • Pentru cache, salvează promisiunea o dată (cache ??= ...) și întoarce-o din funcție, nu din callback.
  • Tratează mereu respingerile cu catch, ca să vezi eroarea cu context.

Întrebări frecvente

De ce nu se blochează pur și simplu programul?

Specificația cere ca motorul să verifice exact acest caz și să respingă promisiunea cu o TypeError, tocmai ca să nu rămână în așteptare pentru totdeauna fără nicio explicație.

Se poate întâmpla și cu await?

Mai rar, dar da: o funcție async care face return pe propria promisiune (salvată într-o variabilă exterioară) dă același ciclu. Soluția e aceeași: întoarce datele.

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.