JSON 工具

parseJson

将一个 JSON 字符串解析为指定类型的对象。支持泛型，可确保类型安全。

参数说明

参数名	类型	必填	说明
str	string	否	要解析的 JSON 字符串

返回值说明

• 类型：T | undefined
• 说明：
  • 成功解析时返回对应类型的对象
  • 输入为空或无效时返回 undefined
  • 若解析失败会抛出异常（由 JSON.parse 抛出）

示例

const jsonStr = '{"name": "Tom", "age": 25}';
const user = parseJson<{ name: string; age: number }>(jsonStr);
console.log(user); // { name: "Tom", age: 25 }

const empty = parseJson<any>(null); // undefined
const empty2 = parseJson<any>(''); // undefined
const empty3 = parseJson<any>('   '); // undefined

// 错误处理（需自行捕获）
try {
  const invalid = parseJson<any>('{"invalid": json}');
} catch (e) {
  console.error('JSON 解析失败:', e);
}