Function: safeJsonParse()

function safeJsonParse<T>(value, fallback?): T | undefined;

Safely parse a JSON string, returning a fallback on failure. 安全地解析 JSON 字符串，解析失败时返回 fallback。

Type Parameters

Type Parameter	Default type	Description
T	unknown	Expected parsed type / 期望的解析类型

Parameters

Parameter	Type	Description
value	unknown	The value to parse (non-string values return fallback) / 待解析的值（非字符串返回 fallback）
fallback?	T	Value returned when parsing fails or input is not a string / 解析失败或输入非字符串时的返回值

Returns

T | undefined

The parsed value, or fallback (default undefined) / 解析结果，或 fallback（默认 undefined）

Example

safeJsonParse<{ a: number }>('{"a":1}') // => { a: 1 }
safeJsonParse('invalid', []) // => []
safeJsonParse(123, 'fb') // => 'fb' (non-string input)
safeJsonParse('not json') // => undefined

Since

1.6.0