Cannot read properties of null (reading 'name')
控制台弹出这一行的时候,页面已经白成了一张纸。我顺着报错栈点进源码,罪魁祸首是两天前我亲手写下的一句:const data = res.data as User。
(说来惭愧,写下它那会儿,看着编辑器里的红色波浪线一下子消失得干干净净,我还挺得意,觉得这行代码敲得真是行云流水。)
那次白屏算是把我敲醒了。平时写前端或者服务端的胶水代码,程序里最容易藏雷的角落,几乎全集中在与外部世界打交道的关口:后端 API 吐回来的响应、浏览器地址栏里的查询参数、用户随手填进表单的字符,还有从 localStorage 里翻出来的陈年旧缓存。刚上手 TypeScript 那阵子,我总喜欢拿 as User 这种类型断言当万金油使,可它说穿了不过是在跟编译器拍胸脯打包票:“信我,绝对不会出事。”至于服务端到底传了什么回来,它一眼都不会替你看。在没有亲手验明正身之前,所有从外头跨进门来的陌生数据,最诚实的身份其实只有一个:unknown。
先当它是陌生人
既然来者皆是 unknown,迎进门的第一道工序自然就是做类型收窄。打那以后,我处理外部接口数据时再也不敢图一时爽快了,而是老老实实在解析函数的入口接一个 unknown:先看它是不是一个非空对象,再顺着结构把关键字段和数组一层层筛查下来。
顺手写一个小小的类型守卫(Type Guard)或者解析器并不费什么工夫,一旦哪一环校验没过,当场就能抛出一条带着明确路径的报错——比如直接点出 user.profile.name 缺失或是类型不对。脏数据在门口就被稳稳拦下,后面的组件也就用不着处处写满问号和兜底分支,提心吊胆地过日子。
状态别拼,直接分开
数据干干净净地进了屋,业务状态本身的建模同样需要往回收拢。就拿日常写得最多的异步请求来说,早些年我习惯拿好几个独立的可选布尔值和字段去拼凑状态,代码写着写着就会冒出很滑稽的画面:loading 明明还是 true,页面上却还挂着上一次留下的 error 报错横幅。
遇到这种有限状态,可辨识联合类型(Discriminated Unions)顺手得多。干脆拆成 idle、loading、success 和 error 四种明确分支:只有走到了 success,类型里才带着业务数据;只有落进了 error,底下才挂着错误对象。再配合 switch 语句把穷尽检查(Exhaustiveness Check)打开,哪天需求变了、多出一种中间状态,编辑器立刻会在每个漏改的地方亮起红灯,再也不用靠记性去全局搜索。
窄一点,但别窄过头
平时写配置项和通用工具函数时,字面量类型、as const 和泛型都是常客,但写久了就会摸出一点分寸感。as const 固然能把配置对象里的字面量原样锁死,可要是随手把每个普通对象都冻结成一长串极窄的只读字面量,鼠标悬停上去弹出一整屏密密麻麻的推导结果,反倒让人认不出它本来长什么样了。
泛型也是同样的道理。只有当一个函数确实需要维系输入和输出之间的对应关系时——比如从数组里筛出同类型的元素,或者给通用的分页响应外壳保留里面包裹的列表项类型——泛型才算真正派上了用场。要是某个泛型除了一对看着唬人的尖括号,骨子里跟直接写 any 没半点分别,既没能约束住入参,也没给返回值带来更准确的提示,那还不如干脆删掉,看着清爽坦荡。
我现在判断一段类型设计到底值不值得留在仓库里,用的尺子很朴素:它有没有实实在在地帮后面的业务代码砍掉多余的判断分支?有没有让潜在的拼写和传参错误在敲键盘的那一刻就暴露出来?一个月后调用这个函数的人,能不能不翻源码就猜对怎么传参?类型系统的本分,是安安静静把那些逻辑上根本不该出现的怪异状态挡在门外,绝非拿来当炫技的摆设。
好的类型设计不仅要拿得起,还得随时放得下。业务组合真复杂,不妨起个贴切的类型别名,把业务意图明明白白写在名字里;可反过来,如果某个拗口的类型别名在全项目里只露了一次脸,除了把编译器的报错信息拉得像瀑布一样长之外毫无益处,那真不如退回去写个平铺直叙的对象接口。一眼能读懂、测试好写、在不需要的时候能痛快删掉,写代码最舒服的节奏大概就是这样。
最后还是得靠测试
那晚合上电脑前,我又把刚补上的单元测试跑了一遍。说到底,编辑器里的类型收窄再严密,也只能在编译期帮我们看住已经写出来的逻辑路径;真正到了线上,守门的还得靠扎扎实实的运行时测试。
现在每次重构完解析层或者改了公共接口,我都会习惯性拿一摞“不太规矩”的样本去喂测试:除了皆大欢喜的正常成功响应,还要专门塞进缺胳膊少腿的残缺对象、把数字传成字符串的错乱字段、前端还没见过的未知状态枚举、空数组,甚至是历史遗留的旧版本结构。毕竟真实世界里随时会飞来意想不到的输入,那是任何一句静态类型声明都替我们挡不住的。
只有当运行时的校验逻辑把这些刁钻样本全都稳稳接住,该报路径的报对了路径,该兜底的兜住了底,那个安静躺在接口文件里的 User,我才算真正信得过它。