第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.parse无法验证字段类型,此工具仅作结构校验;若需校验类型(如age为number),需扩展额外的类型守卫函数。
成功要点:利用Object.fromEntries实现简洁的字段过滤,通过泛型约束保证调用方的类型安全,代码不足30行。