JavaScript / TypeScript / 系统课时

处理外部未知数据

处理外部未知数据

接口响应、配置文件和用户输入即使“看起来像”某个 TypeScript 类型,也仍然只是运行时数据。本节建立一条明确边界:外部值先按 unknown 接收,完成结构校验后,再交给业务代码使用。

学习目标

  • 理解类型断言为什么不能替代运行时数据验证
  • 使用 unknown、类型守卫和显式解析函数收窄外部数据
  • 区分 JSON 语法错误与业务字段结构错误

类型系统不能替代运行时校验

TypeScript 的类型只在编译阶段工作,程序运行后不会自动检查接口对象。value as User 只是在告诉编译器“相信我”,它不会验证 id 是否真是数字,也不会检查必填字段是否存在。因此,断言适合表达开发者已经掌握的类型事实,不适合证明不受信任数据是安全的。

安全边界的核心规则是:外部数据进入程序时保持未知,校验成功后才获得业务类型。这样一旦接口字段漂移、第三方返回异常值或缓存里混入旧结构,错误会停在解析层,而不是在更深的业务逻辑里变成难以定位的异常。

从 unknown 收窄为业务类型

下面用一个最小解析函数处理用户数据。JSON.parse 的结果显式赋给 unknown,随后通过属性检查构造 User。

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

function isRecord(value: unknown): value is Record<string, unknown> {
  return typeof value === "object" && value !== null;
}

function parseUser(input: unknown): User {
  // 外部数据必须先通过结构检查,不能直接断言成 User。
  if (
    !isRecord(input) ||
    typeof input.id !== "number" ||
    typeof input.name !== "string" ||
    typeof input.email !== "string"
  ) {
    throw new Error("接口数据格式不符合 User 约定");
  }

  // 校验成功后重新构造业务对象,避免把未知字段继续带入业务层。
  return { id: input.id, name: input.name, email: input.email };
}

const payload = '{"id":7,"name":"Ada","email":"ada@example.com"}';
const raw: unknown = JSON.parse(payload);
const user = parseUser(raw);

console.log(`${user.id}: ${user.name} <${user.email}>`);

预期输出

text
7: Ada <ada@example.com>

parseUser 的返回类型是 User,所以调用方从这里开始可以安全获得属性补全和静态检查。若字段缺失或类型错误,函数会在边界处抛出异常,而不会返回一个“编译器相信、运行时却不成立”的对象。

把两类失败分开处理

外部 JSON 常见失败有两层。第一层是文本本身不是合法 JSON,此时 JSON.parse 会抛出语法错误;第二层是 JSON 合法,但字段不符合业务约定,此时应由 parseUser 这类校验函数报告结构错误。实际接口层可以统一捕获两类异常,再转换成日志、错误响应或重试策略。

当字段很多、存在嵌套对象、联合类型或复杂规则时,手写守卫会迅速变长。此时可以使用专门的运行时校验库定义 schema,并从 schema 推导静态类型;但无论使用什么工具,都应保留同一个边界原则:先验证真实数据,再相信 TypeScript 类型。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理外部未知数据

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

登录哪都通