TypeScript 4.0升级后鸭子类型校验unknown对象时类型收窄失效触发null报错
问题根因
- TS 4.0 收紧了
in操作符的静态检查规则:操作符右侧的值必须是明确的非空可索引类型,否则会触发*Object is possibly 'null'.ts(2531)*报错。 - 原本的类型收窄逻辑失效,本质是TS4.0对
typeof判断的类型推导存在的已知偏差:由于JS语言本身的特性,typeof null的返回值就是'object',当代码逻辑链中出现typeof arg === 'object'判断时,TS会直接将arg的类型推导为object | null,覆盖掉前面arg != null判断已经完成的null值排除效果。 - 这也是为什么在函数开头增加
if (arg == null) return false;也无法解决问题:只要后续走到typeof arg === 'object'的分支,TS还是会重新把null纳入arg的可能取值范围,导致后续的in操作符检查失败。
适配规则的可行解决方案
以下方案均不使用非空断言,完全符合no-non-null-assertions的规则要求:
- 方案一:在类型链中插入真值判断引导收窄
利用JS中null为假值的特性,在typeof判断后增加一个简单的真值判断,强制TS重新收窄类型,排除null值的可能。这一步判断不改变实际运行时逻辑(非null的对象永远为truthy值),仅用来引导TS完成正确的类型推导:export const isMyType = (arg: unknown): arg is MyType => { return ( arg != null && typeof arg === 'object' && arg && 'prop1' in arg && 'prop2' in arg && 'prop3' in arg ); }; - 方案二:抽离通用非空对象判断工具函数
把非空对象的判断逻辑封装为带类型谓词的独立函数,借助类型谓词的强制收窄效果绕开TS的推导偏差,工具逻辑可在多个类型守卫中复用:// 通用非空对象判断,通过类型谓词明确标注返回值为排除null的对象类型 const isNonNullObject = (value: unknown): value is Record<string, unknown> => { return value !== null && typeof value === 'object'; }; export const isMyType = (arg: unknown): arg is MyType => { if (!isNonNullObject(arg)) return false; return 'prop1' in arg && 'prop2' in arg && 'prop3' in arg; }; - 方案三:拆分逻辑判断,打断TS的自动推导偏差
把连续的逻辑与链拆成分步返回的判断,在每一步完成明确的类型校验,避免TS的推导偏差导致收窄失效。这一步的重复null判断在运行时永远不会命中,作用是让TS明确知道arg在后续代码中不会是null,完成正确的类型收窄:export const isMyType = (arg: unknown): arg is MyType => { if (arg == null) return false; // 在typeof判断分支中显式校验null,明确打断TS自动推导的object|null类型结果 if (typeof arg !== 'object' || arg == null) return false; return 'prop1' in arg && 'prop2' in arg && 'prop3' in arg; };
内容的提问来源于stack exchange,提问作者mellis481
相关产品推荐
相关产品推荐

