知道当前是哪一种:控制流收窄
从多种可能中确认当前类型,理解可辨识属性、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展示同一联合成员中的参数如何共同收窄。判断报错时,依次检查:模型是否表达了关系、检查是否提供了证据、这条路径是否仍可能包含其他情况。
这一页,先记到这里。