第62章 JSON解析与序列化
案例62:JSON解析与序列化——双向转换工具
题目:构建一个类型安全的JSON工具类,支持对象↔字符串双向转换,并在解析失败时给出友好错误提示。
设计思路
使用TypeScript泛型与keyof约束,封装JSON.parse和JSON.stringify。序列化时自动剔除undefined字段,解析时校验目标类型结构,避免运行时类型错误。
核心代码
class JsonTool {
// 序列化:过滤 undefined 字段
static stringify<T extends object>(obj: T): string {
const cleaned = Object.fromEntries(
Object.entries(obj).filter(([, v]) => v !== undefined)
) as T;
return JSON.stringify(cleaned, null, 2);
}
// 解析:检查关键字段是否存在
static parse<T>(json: string, requiredKeys: (keyof T)[]): T {
const data = JSON.parse(json) as T;
for (const key of requiredKeys) {
if (!(key in data)) {
throw new Error(`缺少必要字段: ${String(key)}`);
}
}
return data;
}
}
// 使用示例
interface User { name: string; age?: number; email: string }
const user: User = { name: "张三", email: "zhang@example.com" };
const jsonStr = JsonTool.stringify(user);
console.log("序列化:", jsonStr);
try {
const parsed = JsonTool.parse<User>(jsonStr, ["name", "email"]);
console.log("解析成功:", parsed.name, parsed.email);
} catch (e) {
console.error("解析错误:", (e as Error).message);
}
运行结果
序列化输出为缩进格式的JSON字符串,其中age字段因undefined被过滤;解析操作成功返回原对象。
测试建议
- 传入缺少email的JSON字符串,验证抛出的错误消息。
- 传入非JSON格式的字符串(如"hello"),观察JSON.parse原生报错。
- 传入非JSON格式的字符串(如"hello"),观察JSON.parse原生报错。
注意事项
JSON.parse无法验证字段类型,此工具仅作结构校验;若需校验类型(如age为number),需扩展额外的类型守卫函数。
成功要点:利用
Object.fromEntries实现简洁的字段过滤,通过泛型约束保证调用方的类型安全,代码不足30行。