calmer-json

Safe way to build or parse JSON. Never throws on circular refs and BigInts.

Usage

npm install calmer-json

toJson — stringify

const text = toJson(value, options?)

• value Value to stringify to a JSON text
• options.replacer? Function to transform value entries (if any)
• options.space? String to use to indent or number of spaces for indentation
• options.onError? Callback to handle possible errors and provide a fallback value

Unlike JSON.stringify, toJson never throws on circular references or BigInt values. It just ignores them as non-serializable:

const example = {
  circular: null,
  bigint: BigInt('1'),
  foo: 'bar',
};

example.circular = example;

toJson(example); // -> '{"foo":"bar"}'

fromJson — parse

const value = fromJson(text, options?)

• text String to parse from JSON text to a value
• options.reviver? Function to transform value entries (if any)
• options.onError? Callback to handle possible errors and provide a fallback value