Parse Any JSON

parseJSON

Parses any valid JSON string (including arrays, primitives, or objects) and optionally converts stringified primitives in nested arrays or objects. This utility is ideal when the root value of the JSON could be anything, not just an object.

Example Usage

Function Signature

function parseJSON<T = unknown>(value: string, parsePrimitives?: boolean): T

Parameters

Returns

• T: The parsed JSON value (typed as T), which may be an object, array, string, number, or boolean. Returns {} if the input is not valid JSON.

Key Features

1. Flexible Root: Accepts any valid JSON root (object, array, primitive).
2. Recursive Primitive Conversion: Converts stringified numbers, booleans, null—deeply (see deepParsePrimitives).
3. Safe Fallback: Malformed or invalid JSON always returns an empty object.
4. Type-safe Generic: Infer and enforce types with <T>.

Aliases

Also exported as:

• parseJsonDeep

Limitations

1. Invalid input returns {}: May mask input errors—double-check your sources.
2. Only JSON-safe types: Non-JSON, circular, or function values will not parse.
3. No Reviver Support: Doesn't expose a custom reviver function like JSON.parse.
4. Single Quoted Strings Not Supported: Must be valid JSON (double quotes).

Notes

• For strict object parsing (root must be an object), use parseJsonToObject.
• For deep primitive conversion logic, see deepParsePrimitives.
• Malformed JSON, such as single-quoted or badly formatted strings, will not throw but will result in {}.

Recommended Use Cases

• Parsing unpredictable API or config data.
• Accepting JSON from user input, file uploads, or dynamic sources.
• Applications handling both primitive and complex JSON shapes.