第90章 类型断言与转换

案例90:类型断言与转换——显式转换不同类型

题目:在处理来自外部API的未知数据结构时,需要将 unknown 类型安全地转换为具体类型,并处理转换失败的情况。

设计思路

通过类型断言(as)与自定义类型守卫函数,实现从 unknown 到 User 接口的安全转换。利用 typeof 和 in 运算符在运行时验证数据结构,避免盲目断言导致的运行时错误。

核心代码

interface User {
  id: number;
  name: string;
  age?: number;
}

// 类型守卫:判断是否为合法User
function isUser(data: unknown): data is User {
  if (typeof data !== 'object' || data === null) return false;
  const obj = data as Record<string, unknown>;
  return typeof obj.id === 'number' && typeof obj.name === 'string';
}

// 显式转换函数
function toUser(data: unknown): User {
  if (isUser(data)) {
    return data;  // 此处通过守卫后自动收窄为User
  }
  throw new Error('数据格式不合法,无法转换为User');
}

// 模拟外部数据
const rawData: unknown = { id: 1, name: '张三', age: 25 };
const user = toUser(rawData);
console.log('转换成功:', user.id, user.name, user.age);

// 错误场景演示
try {
  const badData: unknown = { id: 'abc', name: 42 };
  toUser(badData);
} catch (e) {
  console.log('捕获错误:', (e as Error).message);
}

运行结果
转换成功: 1 张三 25
捕获错误: 数据格式不合法,无法转换为User

验证方法
直接运行 ts-node 案例90.ts 或使用 tsc 编译后运行。修改 rawData 的字段类型,观察守卫函数是否正确拦截错误数据。

注意事项
类型断言不会改变运行时数据类型,只能辅助编译器。对于API返回的 unknown 数据,务必先使用类型守卫验证,避免使用双重断言 as unknown as 绕过类型检查。

成功要点
类型守卫(data is User)是实现安全转换的关键,它通过运行时检查将类型收窄,确保后续代码访问属性时不会产生异常。