第92章 unknown类型

案例题目

从外部API接收一个unknown类型的数据(可能是任何内容),编写一个安全的解析函数,将未知输入转换为可信的对象数据,并在处理过程中使用类型守卫进行逐层验证。

设计思路

利用unknown类型的特性——必须先进行类型缩小才能操作,设计三个守卫函数:isRecord、isUser、parseUser。通过逐步收窄,把任意输入安全转换为强类型对象,避免运行时错误。

✅ 核心代码
// 类型守卫:检查是否为对象(非null、非数组)
function isRecord(value: unknown): value is Record<string, unknown> {
  return typeof value === 'object' && value !== null && !Array.isArray(value);
}

// 类型守卫:检查是否为字符串
function isString(value: unknown): value is string {
  return typeof value === 'string';
}

// 类型守卫:检查是否为数字
function isNumber(value: unknown): value is number {
  return typeof value === 'number' && isFinite(value);
}

// 定义User接口
interface User {
  id: number;
  name: string;
  email: string;
}

// 安全解析函数
function parseUser(data: unknown): User {
  if (!isRecord(data)) {
    throw new Error('顶层必须是对象');
  }
  const { id, name, email } = data;
  if (!isNumber(id) || !isString(name) || !isString(email)) {
    throw new Error('字段类型不匹配');
  }
  return { id, name, email };
}

// 测试
try {
  const validData: unknown = { id: 1, name: '张三', email: 'zhang@example.com' };
  console.log('成功:', parseUser(validData));
} catch (e) {
  console.error((e as Error).message);
}

▶️ 运行结果

运行上述代码,控制台输出:成功: { id: 1, name: '张三', email: 'zhang@example.com' }。如果传入{ id: '1', name: '张三', email: 'zhang@example.com' },则会抛出"字段类型不匹配"错误。

💎 测试建议

分别传入:null(触发"顶层必须是对象")、{ id: '2', name: '李四', email: 'li@example.com' }(触发类型错误)、以及合法数据(成功返回)。

⚠️ 注意事项

unknown禁止直接访问属性或调用方法,必须先通过typeof、instanceof或自定义守卫缩小类型。使用any会绕过类型系统,完全失去保护。

🏁 成功要点

掌握了unknown的安全处理模式:类型守卫 + 逐层收窄。这使得外部数据在运行时被严格验证,同时保持编译期的类型安全。