Class: JSONUtils

Defined in: utils/JSONUtils.ts:9

Utility methods for JSON serialization with support for non-finite numbers

NaN, Infinity and -Infinity are encoded as the sentinel strings "__NaN__", "__PositiveInfinity__" and "__NegativeInfinity__", which JSONUtils.parse decodes back into numbers. Strings that happen to equal a sentinel are therefore not round-trip safe.

Constructors

Constructor

new JSONUtils(): JSONUtils

Returns

JSONUtils

Methods

parse()

static parse(text): unknown

Defined in: utils/JSONUtils.ts:66

Parses JSON, decoding the sentinel strings written by JSONUtils.stringify back into NaN, Infinity and -Infinity

Parameters

text

string

The JSON text to parse

Returns

unknown

Throws

If the text is not valid JSON

---

stringify()

static stringify(value, options?): string

Defined in: utils/JSONUtils.ts:30

Serializes a value to JSON, encoding non-finite numbers as sentinel strings

Behaves like JSON.stringify without indentation: toJSON methods are honored, and object properties that cannot be represented (undefined, functions, symbols) are omitted.

It differs from JSON.stringify where the latter is lossy: such a value throws instead of yielding undefined when it is the top-level value, and throws instead of being written as null when it is an array element. It also does not detect circular references, which overflow the stack rather than throwing a TypeError.

Parameters

value

unknown

The value to serialize

options?

Optional stable flag, sorting object keys alphabetically so that the output is independent of property insertion order (default false)

stable?

boolean

Returns

string

Throws

If the value itself, or any array element it contains, cannot be represented in JSON