Parse JSON To Object

parseJsonToObject

The parseJsonToObject function safely parses a JSON string into a JavaScript object. It optionally converts stringified primitive values (like "true", "42") into their actual primitive types (true, 42).

Function Signature

function parseJsonToObject<T extends GenericObject = GenericObject>(
  value: string,
  parsePrimitives?: boolean
): T

Parameters

• value (string): The JSON string to parse.
• parsePrimitives (boolean, optional): When true, automatically parses string values into primitives. Defaults to true.

Return Value

• T: The parsed object. If parsing fails, or if the parsed root is not a plain object, it returns an empty object {}.

Example Usage

Notes

• This function validates that the parsed value is a plain object. Roots like strings, numbers, arrays, or null are rejected and return {}.
• Internally uses parseObjectValues to perform recursive primitive conversions on the object.

See Also

• parseObjectValues - The utility used to convert object property values.
• parseJSON - For parsing general JSON (which can return arrays, numbers, booleans, or null).