TypeScript类型收窄:四种姿势与两个误区
【摘要】 从一个报错开始写 TypeScript 时最常见的报错大概是这一句:"Object is possibly 'undefined'"。很多新手的第一反应是加个 ! 断言把编译器闭嘴,结果把运行时的坑留给了自己。其实编译器不是在找麻烦,它在提醒你:这个值的类型在当前代码路径里还是"union",你需要先收窄(narrowing)它。收窄的四种常用姿势1. 真值判断——最直接的方式,适合能确定"...
从一个报错开始
写 TypeScript 时最常见的报错大概是这一句:"Object is possibly 'undefined'"。很多新手的第一反应是加个 ! 断言把编译器闭嘴,结果把运行时的坑留给了自己。其实编译器不是在找麻烦,它在提醒你:这个值的类型在当前代码路径里还是"union",你需要先收窄(narrowing)它。
收窄的四种常用姿势
1. 真值判断——最直接的方式,适合能确定"空值就是非法输入"的场景:
const el = document.querySelector('#app');
if (el) {
el.innerHTML = 'hello'; // 这里 el 已经是 Element
}
2. 相等判断——当你需要区分"是 null 还是 undefined"时,用全等判断:
if (value === null) return; // value 收窄为非 null 类型
3. in / 判别联合——处理"同一份数据有多种形态"时的利器:
type Shape =
| { kind: 'circle'; radius: number }
| { kind: 'rect'; w: number; h: number };
function area(s: Shape) {
if (s.kind === 'circle') return Math.PI * s.radius ** 2;
return s.w * s.h; // 这里 TS 知道 s 一定是 rect
}
判别联合的关键是每个分支都要有一个字面量类型的判别字段(上面是 kind),switch/if 之后编译器自动收窄,新增形态时漏写分支还会报错。
4. 自定义类型守卫——当判断逻辑复杂时,把收窄逻辑封装成函数:
function isFish(pet: Bird | Fish): pet is Fish {
return 'swim' in pet;
}
返回类型里的 pet is Fish 是关键字语法,告诉编译器"这个函数返回 true 时,参数就是 Fish"。注意 is 和返回 boolean 的普通函数完全不同——后者不会收窄。
两个容易踩的误区
- 非空断言是欠条,不是解药。
el!.innerHTML只是把检查责任推给了运行时。断言只在"你能证明它一定非空,但编译器推不出来"的少数场景合理; - 收窄在回调里会失效。TS 不知道你传进
setTimeout的回调何时执行,if 判断后变量在回调里会被还原成宽类型(除非变量是 const)。这时宁可把收窄后的值赋给一个新 const。
小结
类型收窄的本质是"让类型系统和运行时的真实状态对齐"。遇到 possibly undefined 报错时,先想想这个空值在业务上是否真的可能发生:可能,就老老实实处理;不可能,就找到能证明它不可能的判断写下来——让编译器帮你把这条路径守住。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)