Uncaught typeerror: converting circular structure to json

Have you encountered uncaught typeerror: converting circular structure to json?

This error is common when you are working on your Python project. This error is quite frustrating but apparently, a solution exists.

This error can be fixed in several ways, particularly:

• Using a third-party library
• Manually remove the circular reference
• Implement a custom toJSON method

But before we resolve this typeerror: converting circular structure to JSON error, let’s understand first what and how this error occurs.

What is uncaught typeerror: converting circular structure to json?

“Uncaught TypeError: Converting circular structure to JSON” is an error message that can appear in JavaScript.

It occurs when you try to convert a circular data structure (an object or array that references itself) to a JSON string using the JSON.stringify() method. Since JSON does not support circular references, this causes an error to be thrown.

How to fix uncaught typeerror: converting circular structure to json

There are a few ways to fix the Converting circular structure to JSON error in JavaScript.

Here are three common approaches:

Use a third-party library

There are several third-party libraries available that can handle circular references when stringifying objects to JSON. Some popular options include circular-json, flatted, and json-stringify-safe.

Manually remove the circular reference

If you know which property is causing the circular reference, you can manually remove the reference before stringifying the object.

For example:

const obj = {};
obj.prop = obj; // circular reference

// Remove the circular reference
obj.prop = null;

const jsonString = JSON.stringify(obj);
console.log(jsonString);

Output:

{"prop":null}

Implement a custom toJSON method

You can define a custom toJSON method on your object to control how it is stringified to JSON. This method should return a JSON-safe version of the object without circular references.

For example:

const obj = {};
obj.prop = obj; // circular reference

// Define a custom toJSON method
obj.toJSON = function() {
  return { prop: null };
}

const jsonString = JSON.stringify(obj);
console.log(jsonString);

Output:

{"prop":null}

Note that the best approach will depend on the specific requirements of your project. In some cases, using a third-party library may be the easiest and most efficient solution

Conclusion

In conclusion, the “Uncaught TypeError: Converting circular structure to JSON” error occurs in JavaScript when you try to stringify an object that contains circular references using the JSON.stringify() method. This error can be fixed by using a third-party library, manually removing circular references, or implementing a custom toJSON method.

It’s important to note that circular references can cause unexpected behavior in your code, and it’s generally a good practice to avoid them when possible.

That’s it for this article! By following the outlined solutions above, surely you’ll be able to fix the error.

Anyhow, If you are finding solutions to some errors you might encounter we also have Typeerror: can’t compare offset-naive and offset-aware datetimes.

Understanding int/str/float TypeErrors

Python separates numeric types from strings strictly. Concatenating, comparing, and arithmetic across type boundaries requires explicit conversion.

Common triggers

• User input is always str. input() always returns str. Wrap with int() or float().
• CSV cells are all str. Even numeric-looking columns are strings until converted.
• JSON numbers vs str. json.loads preserves the JSON type — but only “123” as string in the JSON becomes str in Python.
• Format string mismatch. "%d" % "5" raises TypeError. Use int("5") first.
• Compare int and str. Python 3 fails on "1" < 2. Convert one side first.

Diagnostic pattern

# BAD — user input treated as int
age = input("Enter your age: ")
if age >= 18:  # TypeError: '>=' not supported between 'str' and 'int'
    print("Adult")

# GOOD — convert first, guard failure
try:
    age = int(input("Enter your age: "))
except ValueError:
    print("Invalid age")
    age = 0

if age >= 18:
    print("Adult")

Best practices

• Convert at boundaries. Convert input, config values, and API responses to the right type immediately after loading.
• Use pydantic or dataclasses. Modern data validation libraries convert and check types automatically.
• Avoid == across types. Compare like-to-like.

Glay Eliver

Programmer & Technical Writer at PIES IT Solution

Glay Eliver is a programmer and writer at PIES IT Solution, author of over 600 tutorials at itsourcecode.com. Specializes in JavaScript tutorials, Microsoft Office how-tos (Excel, Word, PowerPoint), and Python error debugging covering ImportError, TypeError, AttributeError, ModuleNotFoundError, and JavaScript ReferenceError. Authored several of the site’s highest-traffic Excel and MS Office reference articles.

Expertise: JavaScript · MS Excel · MS Word · MS PowerPoint · Python · Python ImportError · Python TypeError · Python AttributeError · ModuleNotFoundError · JavaScript ReferenceError · Pygame
 · View all posts by Glay Eliver →