TypeError: Converting circular structure to JSON
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
<pre>{{ form | json }}</pre><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
comanda.client = client;
client.comenzi = [comanda];
{{ comanda | json }}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ă 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".
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.
Reparația
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">{{ afisare | json }}</pre>`
})
export class App {
comanda: Comanda = { id: 17 };
afisare = {};
constructor() {
const client: Client = { nume: 'Ana', comenzi: [this.comanda] };
this.comanda.client = client;
this.afisare = { id: this.comanda.id, client: client.nume };
}
}De ce merge
JSON.stringify (folosit de pipe-ul json) a mers din comandă în client, apoi din client.comenzi înapoi în aceeași comandă. Cercul nu se termina, așa că a aruncat TypeError.
Obiectul afisare conține doar valori simple: id-ul comenzii și numele clientului. Nu mai există nicio legătură înapoi, deci pipe-ul îl transformă în text fără probleme.
Alte forme ale mesajului
TypeError: Converting circular structure to JSON --> starting at object with constructor 'Object' --- property 'client' closes the circleTypeError: cyclic object value
Cum o eviți pe viitor
- Folosește
jsondoar 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.logsau 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
NG02100: InvalidPipeArgument: '40712345678' for pipe 'SlicePipe' Pipe-ul slice merge doar pe texte și liste (array). Ai trimis un număr sau un obiect. Păstrează valoarea ca text (de exemplu un telefon sau un cod) sau transform-o cu String() înainte de slice. NG0302: The pipe 'currency' could not be found in the 'App' component. Verify that it is included in the '@Component.imports' of this component. Folosești un pipe în șablon ({{ pret | currency }}) fără să-l fi importat în componentă. În componentele standalone, pipe-urile Angular se importă individual (CurrencyPipe, DatePipe, UpperCasePipe...) în imports: [...] din @Component. NG02100: InvalidPipeArgument: '5' for pipe 'UpperCasePipe' Pipe-urile uppercase, lowercase și titlecase acceptă doar texte (string). Ai trimis un număr, un obiect sau un boolean. Transformă valoarea în text (String(x) sau un template literal) sau aplică pipe-ul doar pe partea de text. Î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.
