JavaScript / TypeScript / 系统课时

联合类型

联合类型

本课解决一个值可能属于多种类型时的建模问题。你将使用联合类型连接多个候选类型,理解只能直接使用它们的公共能力,并通过类型收窄安全访问各自特有的成员。

学习目标

  • 使用 | 声明联合类型
  • 理解联合值只能直接使用公共成员
  • 在分支中收窄后执行类型专属操作

声明联合类型

联合类型使用 | 连接多个类型,表示值只需满足其中一种类型。

ts
function printId(id: number | string): void {
  console.log("ID: " + id);
}

printId(1001);
printId("A-1001");

预期输出

text
ID: 1001
ID: A-1001

调用者可以传入 number 或 string,其他类型会被拒绝。联合类型不是把两个值同时合并,而是表达“当前值属于候选类型之一”。

只能直接使用公共能力

在没有进一步判断前,编译器只允许访问所有候选类型都具备的成员。number 没有 toUpperCase,因此不能直接对 number | string 调用该方法。

ts
function normalize(value: number | string): string {
  if (typeof value === "string") {
    return value.toUpperCase();
  }
  return value.toFixed(2);
}

console.log(normalize("ts"));
console.log(normalize(12.5));

预期输出

text
TS
12.50

typeof 判断让两个分支分别得到 string 和 number,这就是类型收窄。

联合字面量限制取值

联合类型常与字面量类型结合,定义一组有限状态。

ts
type RequestState = "idle" | "loading" | "success" | "error";

function showState(state: RequestState): string {
  return "当前状态:" + state;
}

console.log(showState("loading"));

预期输出

text
当前状态:loading

这种写法比宽泛的 string 更准确,也能让编辑器提供自动补全。传入未列出的字符串会在编译阶段失败。

联合对象类型

对象联合适合描述多种结构。若每种结构包含稳定的判别字段,后续收窄会更清晰。

ts
type Result =
  | { ok: true; data: string }
  | { ok: false; error: string };

function readResult(result: Result): string {
  return result.ok ? result.data : result.error;
}

console.log(readResult({ ok: true, data: "保存成功" }));

预期输出

text
保存成功

ok 同时区分结构和业务状态,编译器可据此判断当前对象拥有 data 还是 error。

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

目录与阅读设置

阅读设置

17

记录一个想法

联合类型

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

登录哪都通