JavaScript / TypeScript / 系统课时

重构与课程总结

重构与课程总结

项目完成后,真正提升质量的步骤是回看类型是否准确、边界是否可信、错误是否可处理。本课通过一次小型重构移除 any 和重复模型,并总结后续进入框架开发前应保留的 TypeScript 习惯。

学习目标

  • 识别常见的不安全类型写法
  • 用单一模型和运行时校验完成重构
  • 建立后续框架学习的 TypeScript 检查清单

识别重构信号

下面代码可以编译,但问题集中:

ts
async function loadOrder(id: any): Promise {
  const response = await fetch(`/api/orders/${id}`);
  const data = await response.json();

  return data as {
    id: string;
    status: string;
  };
}

风险包括:参数允许任意值;返回值丢失类型约束;响应未检查状态码;status 过宽;类型断言没有验证数据。

重构边界与模型

ts
type OrderStatus =
  | "pending"
  | "paid"
  | "cancelled";

interface Order {
  id: string;
  status: OrderStatus;
}

function isOrder(value: unknown): value is Order {
  if (typeof value !== "object" || value === null) {
    return false;
  }

  if (!("id" in value) || typeof value.id !== "string") {
    return false;
  }

  if (!("status" in value)) {
    return false;
  }

  return (
    value.status === "pending" ||
    value.status === "paid" ||
    value.status === "cancelled"
  );
}

async function loadOrder(id: string): Promise {
  const response = await fetch(
    `/api/orders/${encodeURIComponent(id)}`
  );

  if (!response.ok) {
    throw new Error(`Request failed: ${response.status}`);
  }

  const data: unknown = await response.json();

  if (!isOrder(data)) {
    throw new Error("Invalid order response");
  }

  return data;
}

重构后的边界是:调用方提供 string 编号,网络响应进入 unknown,校验通过后才返回 Order。这与 TypeScript 将 unknown 作为更安全顶层类型、通过控制流进行收窄的设计一致。:contentReference[oaicite:12]{index=12}

验证重构结果

使用模拟 fetch 的完整运行示例:

ts
globalThis.fetch = async () =>
  new Response(
    JSON.stringify({
      id: "ORD-1001",
      status: "paid"
    }),
    {
      status: 200,
      headers: { "Content-Type": "application/json" }
    }
  );

const order = await loadOrder("ORD-1001");
console.log(order.id, order.status);

预期输出

text
ORD-1001 paid

项目级检查清单

完成一个 TypeScript 模块后,重点检查:

  • 是否仍有无理由的 any、双重断言或非空断言
  • 外部数据是否先作为 unknown 校验
  • 状态是否使用字面量联合或判别联合
  • 公共函数的输入、输出和错误是否明确
  • 类型检查、测试和构建是否能由一条命令完成
  • 生成产物是否与运行环境的模块规则一致

不要追求“类型越复杂越高级”。稳定项目更看重模型清楚、错误可定位、边界可验证和代码易读。

后续学习路线

进入 React、Vue、Node.js 或服务端框架时,继续沿用本课程的核心顺序:先建模,再验证外部数据,再实现业务逻辑,最后通过类型检查与测试验收。随后可深入泛型约束、条件类型、声明文件、模块发布和项目引用,但应由真实需求驱动复杂度。

本课总结

  • 重构优先消除不安全边界,而不是增加复杂类型技巧
  • unknown → 校验 → 业务类型 是处理外部数据的稳定路径
  • 类型设计、测试、构建和发布应形成同一套工程闭环

下一课预告

本课程到此完成。接下来可选择一个前端或 Node.js 框架项目,把类型建模、API 校验、测试与构建流程应用到真实业务中。

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

目录与阅读设置

阅读设置

17

记录一个想法

重构与课程总结

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

登录哪都通