TypeScript 中用判别联合类型替代 instanceof 检查

写 TypeScript 的人都遇到过这种代码:函数接受多种形态的对象,分支里用 instanceof 或 'foo' in obj 来判断当前是哪一种。这种写法能跑,但类型推导很多时候不到位,重构时也容易遗漏分支。换成判别联合类型(discriminated union)之后整个世界都清爽了。

一个具体例子

假设我们在写一个 HTTP 客户端,请求结果有三种:成功、业务错误(HTTP 200 但 body 里 code 非 0)、网络错误。早期版本可能长这样:

typescript 复制代码
interface Result {
  data?: unknown
  bizError?: { code: number; message: string }
  networkError?: Error
}

function handle(r: Result) {
  if (r.networkError) {
    console.error('network down', r.networkError)
  } else if (r.bizError) {
    console.warn('biz error', r.bizError.code)
  } else {
    console.log('ok', r.data)
  }
}

问题:

  1. 三个字段都是可选的,调用方能构造出 { data: ..., networkError: ... } 这种自相矛盾的对象
  2. else 分支里 TypeScript 并不能保证 r.data 一定存在
  3. 加一种新的结果类型时,编译器不会提醒所有 handle 函数有遗漏

用判别字段重写

typescript 复制代码
type Result =
  | { kind: 'ok'; data: unknown }
  | { kind: 'bizError'; code: number; message: string }
  | { kind: 'networkError'; cause: Error }

function handle(r: Result) {
  switch (r.kind) {
    case 'ok':
      console.log('ok', r.data)
      return
    case 'bizError':
      console.warn('biz error', r.code)
      return
    case 'networkError':
      console.error('network down', r.cause)
      return
  }
}

每个分支里 TypeScript 自动收窄类型:在 case 'ok' 里访问 r.code 会直接报错。三种状态互斥,不可能同时存在。

加上 exhaustiveness check

更进一步,可以加一个 assertNever 让编译器在你忘记处理新分支时直接报错:

typescript 复制代码
function assertNever(x: never): never {
  throw new Error(`Unhandled variant: ${JSON.stringify(x)}`)
}

function handle(r: Result) {
  switch (r.kind) {
    case 'ok': return console.log('ok', r.data)
    case 'bizError': return console.warn('biz error', r.code)
    case 'networkError': return console.error('network down', r.cause)
    default: return assertNever(r)
  }
}

后面如果在 Result 里加了一个 { kind: 'timeout'; afterMs: number },所有 handle 函数会立刻在 assertNever(r) 那行编译错误,因为 r 的类型不再是 never。这个模式在大型代码库里非常救命,相当于给类型系统挂了一个"穷尽性"的开关。

什么时候不适合

判别联合不是免费的:

  • 如果各个变体之间共享字段很多,用判别字段会有重复
  • 如果变体集合是开放的(比如允许第三方扩展),用 class + 接口可能更合适
  • 跨模块边界传输时(JSON、protobuf)要确认 kind 字段在序列化协议里也能保留

但只要你的"几种状态"是闭集合,判别联合几乎总是比 instanceof 或可选字段更好的选择。

相关推荐
Mh13 分钟前
我是如何设计品牌站组件库的?
前端·css·设计模式
程序员大阳1 小时前
副队长Vue3教程(2)--Vite 搭建 Vue 项目,认识目录结构
前端·javascript·vue.js·vite·创建项目·目录结构·项目结构
濮水大叔1 小时前
Cabloy/Zova 与 Next.js 的 SSR 水合差异
前端·typescript·next.js
SoaringHeart2 小时前
Flutter最佳实践:用 flutter_html 渲染富文本
前端·flutter
Flynt3 小时前
Chrome给AI编程助手塞了203篇前端规范,我拆包实测:检索0.77秒是真快,扫描器有点挑食
前端·chrome·ai编程
北城笑笑3 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
程序员韩星4 小时前
OpenAI 兼容接口返回 404,先查请求地址,再查模型名
前端·人工智能·http
Patrick_Wilson4 小时前
构建通过了,为什么有些浏览器还会白屏?
前端·javascript·浏览器
其实防守也摸鱼5 小时前
用 Claude Code 重构遗留系统:从评估到落地的完整指南
前端·网络·人工智能·chrome·安全·重构
七仔啊5 小时前
CNC计算机数控加工模拟器
前端