TypeScript 如何在不创建函数的前提下为变量指定类型谓词
报错核心原因
TypeScript的内联类型收窄是实时追踪if条件内变量类型的:当判断逻辑直接写在if的括号中,TS会在判断执行的瞬间校验原变量的类型,自动完成类型收窄,所以内联写法可以正常通过校验。
但如果把判断结果单独存成布尔变量,TS默认不会自动把这个布尔值的状态和原变量的类型建立关联——因为TS无法保证:在布尔变量定义完成后、if块执行前,原变量有没有被重新赋值,导致布尔值的真实状态和原变量的实际类型不匹配。
从TS 4.4版本开始,官方新增了别名条件收窄能力,只要满足以下规则,完全不需要写自定义类型守卫函数,TS就可以识别存为变量的判断逻辑的类型守卫作用:
- 存判断结果的变量必须是
const声明(不能用let/var,否则变量本身可能被重新赋值,TS无法追踪其状态) - 这个const变量的初始值必须是纯类型判断表达式,不能包含复杂分支逻辑
- 被判断的原变量,在判断变量定义完成后、到if块使用的位置之间,没有任何重新赋值的操作
你写的代码触发报错,本质是因为point是let声明,且在定义isPointNotUndefined时还没有完成明确赋值,TS控制流分析认为从isPointNotUndefined定义到if判断的区间内,point存在被重新赋值为undefined的可能性,所以不会主动关联两者的类型关系。
无自定义函数的解决方案
- 适配别名收窄的规则
先将项目TypeScript版本升级到4.4及以上,调整代码结构:在定义存判断结果的const变量前,先完成point的赋值,同时保证从判断变量定义到if块之间,不对point做任何重新赋值操作。示例代码:let point: number | undefined; // 先给point完成赋值(比如从接口、业务函数取值) point = getCurrentPoint(); // 再定义判断常量 const isPointNotUndefined = point !== undefined; if (isPointNotUndefined) { // TS自动识别此时point为number类型,不会抛出类型错误 point2 = point; } - 无法提前初始化的场景
如果point是异步赋值、或者无法在定义判断变量前完成赋值,可以在if块内通过非空断言完成临时收窄,这种方式需要手动保证判断逻辑和实际类型一致:
注意这种方式相当于绕过了TS的自动校验,如果let point: number | undefined; const isPointNotUndefined = point !== undefined; if (isPointNotUndefined) { // 手动断言point此时已排除undefined类型 point2 = point!; }isPointNotUndefined为true时point实际为undefined,会直接触发运行时错误。 - 低版本TS兼容写法
如果项目还在使用4.4之前的TS版本,又不想写自定义守卫函数,可以在if判断中搭配一个简单的内联类型校验,既保留已有的布尔变量判断,又能触发TS的自动收窄:let point: number | undefined; const isPointNotUndefined = point !== undefined; if (isPointNotUndefined && point !== undefined) { point2 = point; }
内容的提问来源于stack exchange,提问作者Vladimir Fomin
相关产品推荐
相关产品推荐

