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.50typeof 判断让两个分支分别得到 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。
按自己的节奏,确认真正理解。