JSPM

safe-stringify

0.0.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 28901
  • Score
    100M100P100Q142487F
  • License MIT

A safe substitute for JSON.stringify

Package Exports

  • safe-stringify

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (safe-stringify) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

safe-stringify

Serialize objects to JSON with handling for circular references

JSON.stringify() throws an error if the object contains circular references. This package replaces circular references with "[Circular]".

Install

npm install safe-stringify

Usage

import safeStringify from 'safe-stringify';

const foo = {a: true};
foo.b = foo;

console.log(safeStringify(foo));
//=> '{"a":true,"b":"[Circular]"}'

console.log(JSON.stringify(foo));
//=> TypeError: Converting circular structure to JSON

API

safeStringify(value, options?)

Returns a string.

Note: There is no replacer option as I didn't need that, but “pull request welcome” if you need it.

value

Type: unknown

The value to convert to a JSON string.

options

Type: object

indentation

Type: 'string' | 'number'

The indentation of the JSON.

By default, the JSON is not indented. Set it to '\t' for tab indentation or the number of spaces you want.

FAQ

Why another safe stringify package?

The existing ones either did too much, did it incorrectly, or used inefficient code (not using WeakSet). For example, many packages incorrectly replaced all duplicate objects, not just circular references, and did not handle circular arrays.

  • decircular - Remove circular references from objects