TypeError: Chaining cycle detected for promise #<Promise>
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, facireturn incarcareîn callback; - o logică de cache care întoarce promisiunea din cache chiar în timp ce o rezolvă;
- un
resolve(p)în constructorulnew Promise, undepe 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
const incarcare = cerere().then((r) => {
cache.produse = r.date;
return incarcare;
});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
const p = new Promise((resolve) => {
setTimeout(() => resolve(p), 10);
});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ă
let cache;
function ia() {
cache = cerere().then(() => cache);
return cache;
}let cache;
function ia() {
cache ??= cerere().then((r) => r.date);
return cache;
}Cache-ul păstrează promisiunea, dar callback-ul ei întoarce datele.
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.
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}`);
});Produse: 2
Indiciu
Callback-ul trebuie să întoarcă lista de produse, nu promisiunea incarcare.
Reparația
function cerereSimulata() {
return Promise.resolve({ ok: true, date: ["cană", "lampă"] });
}
const cache = {};
const incarcare = cerereSimulata().then((r) => {
cache.produse = r.date;
return r.date;
});
incarcare.then((produse) => {
console.log(`Produse: ${produse.length}`);
});De ce merge
incarcare este promisiunea creată de then. Când callback-ul întorcea incarcare, promisiunea trebuia să se rezolve cu ea însăși, ceea ce ar fi însemnat o așteptare fără sfârșit, așa că motorul a respins-o cu TypeError. Cu return r.date, promisiunea incarcare se rezolvă cu lista de produse, iar al doilea then primește tabloul cu două elemente.
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 luithen. - 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
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`. TypeError: Promise resolver undefined is not a function Ai creat `new Promise(...)` fără o funcție executor: fără argument, cu o valoare sau cu rezultatul unui apel (`new Promise(setTimeout(...))`). Constructorul vrea o funcție `(resolve, reject) => { ... }`. Pentru o pauză scrie `new Promise((resolve) => setTimeout(resolve, ms))`. AggregateError: All promises were rejected `Promise.any` a eșuat pentru că toate promisiunile primite au fost respinse (sau lista era goală). Erorile individuale sunt în `e.errors`. Prinde eroarea cu `try...catch` sau `.catch` și citește `e.errors` ca să vezi de ce a picat fiecare sursă. Î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.
