React / 系统课时

类型收窄与异常处理

类型收窄与异常处理

来自接口、浏览器存储或异常捕获的值都可能不可信。本课将用 unknown 建立类型边界,再通过类型守卫和判别联合逐步收窄,最终得到既安全又便于维护的输入校验与异常处理代码。

学习目标

  • 理解 unknown 与 any 的关键差异,并在使用前完成类型检查
  • 编写自定义类型守卫,安全读取不可信对象的属性
  • 使用判别联合处理成功、失败和异常分支

从 unknown 开始建立边界

any 会绕过类型检查,错误通常要到运行时才暴露;unknown 则要求先证明值的类型,才能访问属性或调用方法。因此,接口响应、反序列化结果和 catch 捕获值应优先视为 unknown。

收窄的核心不是强制断言,而是执行可验证的运行时检查。常用手段包括 typeof、instanceof、in 运算符和返回类型谓词的自定义函数。

主示例:校验输入并统一异常

下面的示例先判断输入是否为非空对象,再校验字段类型。解析结果使用 kind 作为判别字段,调用方只需根据该字段进入对应分支。

ts
type User = {
  id: number;
  name: string;
};

type ParseResult =
  | { kind: "success"; data: User }
  | { kind: "failure"; message: string };

function isRecord(value: unknown): value is Record<string, unknown> {
  // 排除 null,因为 typeof null 的结果也是 object
  return typeof value === "object" && value !== null;
}

function parseUser(input: unknown): ParseResult {
  if (!isRecord(input)) {
    return { kind: "failure", message: "输入必须是对象" };
  }

  const { id, name } = input;
  if (typeof id !== "number" || typeof name !== "string") {
    return {
      kind: "failure",
      message: "id 必须是 number,name 必须是 string",
    };
  }

  return { kind: "success", data: { id, name } };
}

function getErrorMessage(error: unknown): string {
  if (error instanceof Error) {
    return error.message;
  }

  if (typeof error === "string") {
    return error;
  }

  return "未知异常";
}

function printResult(result: ParseResult): void {
  // kind 被判断后,TypeScript 会自动收窄当前联合成员
  if (result.kind === "success") {
    console.log(`用户 ${result.data.id}: ${result.data.name}`);
    return;
  }

  console.log(`解析失败: ${result.message}`);
}

function main(): void {
  const inputs: unknown[] = [
    { id: 1, name: "Ada" },
    { id: "2", name: "Grace" },
    null,
  ];

  for (const input of inputs) {
    printResult(parseUser(input));
  }

  try {
    throw new Error("网络不可用");
  } catch (error: unknown) {
    console.log(`捕获异常: ${getErrorMessage(error)}`);
  }
}

main();

预期输出

text
用户 1: Ada
解析失败: id 必须是 number,name 必须是 string
解析失败: 输入必须是对象
捕获异常: 网络不可用

关键边界与常见错误

不要用 input as User 代替校验。类型断言只改变编译器的看法,不会检查真实数据;字段缺失时,后续代码仍可能报错。

判别联合的判别字段应使用稳定的字面量,例如 success、failure 或业务状态码。处理分支时优先覆盖所有成员,联合类型新增状态后才能及时发现遗漏。

异常值不一定是 Error 对象,JavaScript 允许抛出字符串、数字或任意对象。因此,读取 error.message 前必须先通过 instanceof Error 等方式收窄。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

类型收窄与异常处理

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通