TypeScript类型收窄:四种姿势与两个误区

举报
yd_212407902 发表于 2026/11/18 00:43:29 2026/11/18
【摘要】 从一个报错开始写 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)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。