...
Eroare Angular · Pipes

TypeError: Converting circular structure to JSON

Pe scurt

Pipe-ul json (sau JSON.stringify) a primit un obiect care se conține pe sine: de exemplu o comandă cu legătură spre client, iar clientul cu legătură înapoi spre comandă. Afișează doar câmpurile simple sau construiește un obiect fără referința circulară.

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

Ce înseamnă

JsonPipe folosește JSON.stringify, care parcurge obiectul în adâncime. Dacă la un moment dat ajunge din nou la un obiect deja vizitat (o referință circulară), nu se mai poate opri și aruncă TypeError: Converting circular structure to JSON. În Chrome mesajul continuă cu drumul: --> starting at object with constructor 'Object' --- property 'client' closes the circle, deci vezi exact proprietatea care închide cercul.

În aplicații Angular apare când afișezi pentru depanare ({{ x | json }}) obiecte cu legături în ambele sensuri (părinte și copil, comandă și client), obiecte de bibliotecă (FormGroup, HttpErrorResponse cu obiecte interne, elemente DOM, ElementRef) sau componenta însăși ({{ this | json }}).

Reparații: afișezi doar partea de interes ({{ form.value | json }} în loc de {{ form | json }}), construiești un obiect simplu pentru afișare, sau, pentru depanare, folosești console.log, care știe să arate obiecte circulare.

De ce apare: cauzele frecvente

1FormGroup trecut prin json

Greșit
TypeScript
<pre>{{ form | json }}</pre>
Corect
TypeScript
<pre>{{ form.value | json }}</pre>

form.value e un obiect simplu cu valorile; FormGroup are referințe interne către părinte și controale.

2Obiect cu legătură înapoi

Greșit
TypeScript
comanda.client = client;
client.comenzi = [comanda];
{{ comanda | json }}
Corect
TypeScript
afisare = computed(() => ({ id: this.comanda.id, client: this.comanda.client.nume }));
{{ afisare() | json }}

Obiectul afișat conține doar valori simple, fără legătura înapoi.

Repară tu

Repară eroarea, direct în pagină

Pentru depanare, pagina afișează comanda cu pipe-ul json, dar comanda are o legătură spre client, iar clientul o legătură înapoi spre comandă, deci aplicația se oprește cu „Converting circular structure to JSON”. Afișează cu json doar obiectul { id, client }, unde client e numele, ca pre#debug să conțină "client": "Ana".

Codul care dă eroarea
TypeScript
import { Component } from '@angular/core';
import { JsonPipe } from '@angular/common';

interface Client { nume: string; comenzi: Comanda[]; }
interface Comanda { id: number; client?: Client; }

@Component({
  selector: 'app-root',
  imports: [JsonPipe],
  template: `<pre id="debug">{{ comanda | json }}</pre>`
})
export class App {
  comanda: Comanda = { id: 17 };
  afisare = {};

  constructor() {
    const client: Client = { nume: 'Ana', comenzi: [this.comanda] };
    this.comanda.client = client;
  }
}
Indiciu

Construiește pentru afișare un obiect fără legătura înapoi.

Alte forme ale mesajului

  • TypeError: Converting circular structure to JSON --> starting at object with constructor 'Object' --- property 'client' closes the circle
  • TypeError: cyclic object value

Cum o eviți pe viitor

  • Folosește json doar pe date simple (răspunsuri API, form.value), nu pe obiecte de framework.
  • Evită legăturile în ambele sensuri în modelele de date; păstrează id-uri în loc de obiecte (clientId).
  • Pentru depanare, console.log sau Angular DevTools arată obiectele circulare fără eroare.

Întrebări frecvente

De ce console.log merge, iar json nu?

Consola browserului afișează obiectele interactiv, deschizând câte un nivel la cerere, și marchează referințele repetate. JSON.stringify trebuie să producă un text complet, care la o structură circulară ar fi infinit.

Firefox spune „cyclic object value”. E aceeași eroare?

Da. Firefox numește aceeași situație TypeError: cyclic object value; cauza și reparația sunt identice.

Erori înrudite

← Toate erorile Angular

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ță Angular de la zero, cu exerciții la fiecare lecție

Curs Angular: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.