Web 和 Node 有 AbortController 做异步任务取消------signal 挂出去,abort 一调所有 listener 都停。ArkTS 没有标准 AbortController(截至写文章时),但做 app 时经常要"取消一组还没触发的 setTimeout ":用户在 Loading 画面点返回键的瞬间,背后那串"700ms 后 step=1 → 1500ms 后 step=2 → 2400ms 后 finish"的 setTimeout 都应该作废,不能继续污染新页面。前阵子做 MBTI 测试 app 的开场动画时用了自增 token + 回调入口对比 的做法。记录一下,顺便分享给有需要的朋友。
一、嵌套 setTimeout 的默认 bug
Loading 画面的典型实现:
typescript
// ❌ 没有取消机制
private beginLoadingFlow(): void {
this.loadingStep = 0
this.currentScreen = AppScreen.Loading
setTimeout(() => {
this.loadingStep = 1
}, 700)
setTimeout(() => {
this.loadingStep = 2
this.resultCode.split('').forEach((char, index) => {
setTimeout(() => {
this.revealCode += char // 逐字符 reveal 动画
}, index * 120)
})
}, 1500)
setTimeout(() => {
this.finishLoadingFlow()
}, 2400)
}
问题:
- 用户在 Loading 画面点返回 :UI 已经跳回首页,但那串 setTimeout 还在 event loop 里。700ms 后触发时
loadingStep被改成 1,revealCode 开始累加字符......但当前页面不是 Loading 了,这些 state 修改要么没用(没有组件读)要么污染了新页面(如果新页面也用了 loadingStep) - 用户快速按两次"开始测试" :两次 beginLoadingFlow 并发触发,两组 setTimeout 都在跑。revealCode 从两个来源同时累加字符,变成乱码
朴素思路:存所有 setTimeout 的 id,取消时 clearTimeout 一遍。
typescript
private pendingTimers: number[] = []
private beginLoadingFlow(): void {
this.cancelPendingTimers()
this.pendingTimers.push(setTimeout(() => { ... }, 700))
this.pendingTimers.push(setTimeout(() => { ... }, 1500))
// ...
}
private cancelPendingTimers(): void {
this.pendingTimers.forEach(id => clearTimeout(id))
this.pendingTimers = []
}
但对嵌套 setTimeout 无效 。1500ms 的那个回调里嵌套了 N 个 120ms setTimeout------这些是运行时才创建的,不在初始的 pendingTimers 列表里。clearTimeout 挡不住。
二、自增 token:谁最新谁有效
真实做法:每次开始一轮 flow 时自增一个 token,每个 setTimeout 的回调入口先对比 token:
typescript
// Index.ets:67
@State loadingFlowToken: number = 0
private beginLoadingFlow(): void {
this.loadingFlowToken += 1 // 自增
const flowToken = this.loadingFlowToken // 本地闭包捕获
this.loadingStep = 0
this.revealCode = ''
this.currentScreen = AppScreen.Loading
setTimeout(() => {
if (this.loadingFlowToken !== flowToken) return // 👈 不是当前 flow,退出
this.loadingStep = 1
}, 700)
setTimeout(() => {
if (this.loadingFlowToken !== flowToken) return // 👈
this.loadingStep = 2
this.revealCode = ''
this.resultCode.split('').forEach((char, index) => {
setTimeout(() => {
// 嵌套 setTimeout 的入口也要对比
if (this.loadingFlowToken !== flowToken || this.loadingStep !== 2) return // 👈
this.revealCode = `${this.revealCode}${char}`
}, index * 120)
})
}, 1500)
setTimeout(() => {
void this.finishLoadingFlow(flowToken) // flowToken 传下去
}, 2400)
}
private async finishLoadingFlow(flowToken: number): Promise<void> {
if (this.loadingFlowToken !== flowToken) return
// ... 跳转到结果页
}
要点:
this.loadingFlowToken += 1 第一行:开始新 flow 的瞬间就自增。老 flow 的所有 setTimeout 回调都会在入口对比失败而退出。
const flowToken = this.loadingFlowToken 本地捕获 :闭包里的 flowToken 是本地变量。老 flow 的 setTimeout 回调拿到的永远是它启动时的 token,不受后续 this.loadingFlowToken += 1 影响。
每个 setTimeout 回调入口都对比 :包括嵌套的 setTimeout。不嵌套层级越深越容易漏,所有层都要检查。
取消一轮 flow = 只需要 this.loadingFlowToken += 1。不需要存 timer id 数组,不需要 clearTimeout。所有活着的旧 flow 回调自己识别并退出。
三、取消点:进入 / 跳转 / 返回
什么时候要自增 token(= 取消旧 flow):
typescript
// 用户点返回键
onBackPress(): void {
this.loadingFlowToken += 1 // 😄 取消 loading flow
this.currentScreen = AppScreen.Home
}
// 用户直接跳到 archive 页
private openArchive(): void {
this.loadingFlowToken += 1 // 取消任何 pending loading
this.clearColliderState()
this.currentScreen = AppScreen.Archive
this.resetMessages()
}
// 用户重新开始测试
private restartQuiz(): void {
this.loadingFlowToken += 1
this.beginQuiz()
}
原则 :任何会"改变当前 screen"的操作 都应该先把 flowToken 自增。老 flow 的后续回调就都失效。
四、多个独立 flow 用多个 token
一个 app 可能有多个独立的异步 flow:
splashFlowToken:启动页的动画 flowloadingFlowToken:loading 画面的动画 flowexportFlowToken:导出结果海报的 flowshareFlowToken:分享面板的 flow
每个 flow 独立一个 token:
typescript
@State splashFlowToken: number = 0
@State loadingFlowToken: number = 0
private beginSplashFlow(): void {
this.splashFlowToken += 1
const flowToken = this.splashFlowToken
setTimeout(() => {
if (this.splashFlowToken !== flowToken) return
// ...
}, 2000)
}
互不干扰:取消 loadingFlow 不会影响 splashFlow。设备上的多个 flow 可能部分重叠,各自管各自的生命周期。
五、@State flowToken 自增会不会触发重渲染?
警觉的读者会问:flowToken 是 @State,自增一次会不会导致整个 build() 重跑?
答案是:会。但一般没副作用。
build()重跑是声明式 UI 的常态,鸿蒙的 ArkUI 会做 diff 决定哪些组件真正更新- 大部分组件和 flowToken 无关,diff 后不重渲染
- 极端场景下真的有性能问题(build 频繁),可以用普通字段(不加 @State)或 private 字段
typescript
// 普通字段版本
private loadingFlowToken: number = 0 // 不加 @State
private beginLoadingFlow(): void {
this.loadingFlowToken += 1 // 不触发 build() 重跑
// ...
}
什么时候 token 必须是 @State:
- UI 层里要读 flowToken(比如 "当前 flow 是第几次" 之类的 debug UI)
- flowToken 变化需要触发某个 @Watch
什么时候 token 用普通字段:
- 只在逻辑层对比用,UI 不关心
- 节省 build() 开销
本篇场景 @State 更稳------因为可能有 Watcher 或 UI 需要感知"loading 状态被取消"。
六、和 AbortController 的对比
对比 Web 的 AbortController:
typescript
// Web
const controller = new AbortController()
fetch(url, { signal: controller.signal })
setTimeout(() => { ... }, 1000, { signal: controller.signal }) // Node 20+
// 取消
controller.abort()
AbortController 优点:
- 对任何支持 signal 的 API 统一取消(fetch / setTimeout / event listener / ReadableStream)
- 父子 signal 组合,一处 abort 全链路停
- 可以附加 reason(为什么取消)
自增 token 的"等价功能":
- 只能取消 自己串起来的 setTimeout 链,不能取消 fetch 之类的
- 没有自动"父子"关系,多个 flow 要多个 token 手工管
- 没有 reason,就是一个数字对比
但在只需要取消一组 setTimeout 的场景(典型就是动画 flow),自增 token 够用而且简洁。等 ArkTS 原生支持 AbortController 的那天再迁,很简单。
踩坑清单
- 嵌套 setTimeout 的 clearTimeout 无法取消运行时才创建的 timer → 用自增 token 代替
- 每个 flow 独立一个 token:
this.loadingFlowToken += 1→ 本地 const 捕获 - 每个 setTimeout 回调入口都要
if (this.flowToken !== flowToken) return - 嵌套的 setTimeout 入口也要对比(容易漏)
- 取消一轮 flow =
this.flowToken += 1,不需要存 timer id - 多个独立 flow 用多个 token(splash / loading / export / share)
- token 用
@State(UI 感知)或普通字段(纯逻辑层),看是否要触发 build() - 本质是 AbortController 的轻量版,只覆盖"取消 setTimeout 链"场景
尾声
这个 "自增 token 做取消" 的 pattern 在 ArkTS 之外也老早就有 。React 的 useRef 存 token 防组件 unmount 后 setState 的 warning,就是同一个思路。Swift 的 Task 用 cancel 配合 Task.checkCancellation()------也是用一个标志位让异步任务自检退出。
异步任务的本质 :它一旦被调度就不属于任何 context,它只能从"外部状态"知道自己是否该停。token、flag、signal 都是不同形态的"外部状态"。
ArkTS 做 app 时碰到类似问题比预期多:动画 flow、网络请求、位置更新、动画 frame tick------都该考虑取消机制。自增 token 是最轻的、不依赖任何库的、ArkTS 立刻能用的方案。等官方 AbortController 来了再做迁移,几行代码的事。