...
Eroare JavaScript · JSON: parse și stringify

TypeError: Converting circular structure to JSON

Pe scurt

`JSON.stringify` a dat peste un obiect care se conține pe el însuși, direct sau printr-un lanț (de exemplu un copil cu referință la părinte). JSON nu poate reprezenta cicluri. Serializează doar câmpurile de care ai nevoie, elimină referința înapoi sau folosește un replacer.

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

Ce înseamnă

JSON.stringify parcurge obiectul în adâncime și scrie fiecare proprietate. Dacă un obiect are o proprietate care duce, mai devreme sau mai târziu, înapoi la el, parcurgerea nu s-ar termina niciodată, așa că funcția se oprește cu Converting circular structure to JSON.

În Chrome și Node, mesajul complet arată și ciclul:

--> starting at object with constructor 'Object'
|     property 'angajati' -> object with constructor 'Array'
|     index 0 -> object with constructor 'Object'
--- property 'firma' closes the circle

Citești de sus în jos: obiectul de start, drumul prin proprietăți și proprietatea care închide cercul (aici firma).

Cazuri tipice: structuri părinte-copil cu referință înapoi (copil.parinte = parinte), elemente DOM, obiecte de request/response din Express sau Axios, instanțe de biblioteci, sau obiecte de eroare cu context atașat. Aproape niciodată nu ai nevoie să serializezi tot obiectul: alege câmpurile utile.

De ce apare: cauzele frecvente

1Referință înapoi la părinte

Greșit
JavaScript
const firma = { nume: "AP", angajati: [] };
const ana = { nume: "Ana", firma };
firma.angajati.push(ana);
JSON.stringify(firma);
Corect
JavaScript
const firma = { nume: "AP", angajati: [] };
const ana = { nume: "Ana", firma };
firma.angajati.push(ana);
JSON.stringify({
  nume: firma.nume,
  angajati: firma.angajati.map((a) => a.nume)
});

Serializezi o formă simplificată, fără referința firma din fiecare angajat.

2Replacer care omite cheia ciclică

Greșit
JavaScript
JSON.stringify(nod);
Corect
JavaScript
JSON.stringify(nod, (cheie, valoare) => (cheie === "parinte" ? undefined : valoare));

Un replacer care returnează undefined elimină proprietatea din rezultat.

3Obiecte mari de bibliotecă

Greșit
JavaScript
app.get("/", (req, res) => {
  console.log(JSON.stringify(req));
});
Corect
JavaScript
app.get("/", (req, res) => {
  console.log(JSON.stringify({ metoda: req.method, url: req.url }));
});

Obiectele de request conțin referințe interne ciclice. Extrage doar câmpurile utile.

Repară tu

Repară eroarea, direct în pagină

Fiecare sarcină din proiectul de mai jos are o referință înapoi la proiect, iar JSON.stringify(proiect) se oprește cu TypeError: Converting circular structure to JSON. Folosește un replacer care omite cheia proiect ca programul să afișeze JSON-ul proiectului fără referința înapoi.

Codul care dă eroarea
JavaScript
const proiect = { nume: "Site nou", sarcini: [] };
proiect.sarcini.push({ titlu: "Design", proiect });
proiect.sarcini.push({ titlu: "Cod", proiect });

console.log(JSON.stringify(proiect));
După reparație, programul afișează
{"nume":"Site nou","sarcini":[{"titlu":"Design"},{"titlu":"Cod"}]}
Indiciu

Al doilea argument al lui JSON.stringify poate fi o funcție (cheie, valoare) => ...; dacă returnează undefined, cheia e omisă.

Alte forme ale mesajului

  • TypeError: Converting circular structure to JSON --> starting at object with constructor 'Object' --- property 'parinte' closes the circle
  • TypeError: cyclic object value
  • TypeError: JSON.stringify cannot serialize cyclic structures.

Cum o eviți pe viitor

  • Serializează date simple (DTO): construiește explicit obiectul care pleacă spre server sau spre fișier.
  • În structurile părinte-copil, ține legătura printr-un ID (parinteId), nu prin obiectul întreg.
  • Pentru afișare în consolă, console.log(obj) arată și obiectele ciclice, fără JSON.stringify.
  • Pentru copii profunde de obiecte ciclice, folosește structuredClone, care suportă cicluri.

Întrebări frecvente

Cum găsesc ciclul?

Citește mesajul complet din Chrome sau Node: îți arată drumul prin proprietăți și cheia care închide cercul.

structuredClone merge pe obiecte ciclice?

Da, structuredClone copiază corect și structurile ciclice. Nu produce însă text, deci nu înlocuiește JSON.stringify pentru trimiterea datelor.

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.