知道当前是哪一种:控制流收窄

从多种可能中确认当前类型,理解可辨识属性、in 与控制流路径。

本章目录CONTENTS ↓

通知可能是保存成功,也可能是失败。接收它的函数不能一开始就读取成功通知的 id,因为当前值也可能没有这个字段。但函数已经检查了 kind,接下来能否安全读取对应数据?

类型系统需要利用程序里已经获得的证据,在不同路径上缩小可能范围,这就是控制流收窄。它是消费联合类型的基础,也帮助区分运行时的条件判断与后面要学的条件类型计算。联合的候选含义先见联合与交叉。

从输入到安全使用

通知可能表示保存成功,也可能表示失败。两种通知需要的数据不同,把合法组合放进同一个联合成员,就能通过 kind 确认完整结构。

type Notice =
| { kind: "saved"; id: string }
| { kind: "failed"; error: unknown };
function describe(notice: Notice): string {
if (notice.kind === "saved") {
return `已保存 ${notice.id.toUpperCase()}`;
}
if (notice.error instanceof Error) {
return notice.error.message;
}
return "保存失败";
}

这里有两层信息变化:判断 kind 确认是哪种通知;判断 instanceof Error 确认异常值能否读取 message。失败通知一定有 error,却不保证它是 Error 实例,因为 JavaScript 可以抛出其他值。

unknown 能接收任意值,但使用具体操作前需要证明其结构。用断言写成 error as Error 只改变编译器的看法,没有完成这项运行时检查。

控制流决定信息在哪里成立

上例的成功分支执行 return,所以后面的代码只能由失败分支到达。如果只是打印,两个成员仍然都可能走到后续位置。

function logNotice(notice: Notice): void {
if (notice.kind === "saved") {
console.log(notice.id);
}
// @ts-expect-error 成功和失败都能到达这里
console.log(notice.error);
}

因此不能用“if 内已收窄、if 外未收窄”概括规则。应该看分支是否返回、抛出或继续执行,以及变量是否发生赋值。收窄描述当前位置掌握的信息,不是永久改写变量的声明类型。

选择与模型相符的检查

已有信息 常用检查 需要留意
原始值类型不同 typeof value === "number" 保留尚未排除的其他成员。
有共同的字面量标签 notice.kind === "saved" 标签和数据必须先在模型中关联。
某属性只属于部分成员 "percent" in payload 可选属性可能让同一成员出现在两个分支。
可能缺省的值 index !== undefined 真值检查还会排除 0、空字符串等合法值。
类实例 error instanceof Error 只证明此检查匹配到的实例类型。
type Payload = { userId: string } | { percent: number };
function show(payload: Payload): string {
if ("userId" in payload) return payload.userId.toUpperCase();
return payload.percent.toFixed(0);
}

本例使用必填属性,检查能区分两个成员。若类型本身没有表达关联,例如两个独立的联合字段,检查其中一个字段不会凭空建立关联。先修正模型,再选择收窄方式,通常比补断言更可靠。

用到完整问题中

请求状态建模展示如何选择模型;事件 API展示同一联合成员中的参数如何共同收窄。判断报错时,依次检查:模型是否表达了关系、检查是否提供了证据、这条路径是否仍可能包含其他情况。

具体守卫形式、自定义类型谓词和控制流边界,可查官方 Narrowing。回到全景与阅读路线。

这一页,先记到这里。