ArkTS 没有 AbortController 怎么取消 setTimeout 链用自增 token 的做法

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:启动页的动画 flow
  • loadingFlowToken:loading 画面的动画 flow
  • exportFlowToken:导出结果海报的 flow
  • shareFlowToken:分享面板的 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 来了再做迁移,几行代码的事。

相关推荐
不可能片场30 分钟前
工程实践 雪花id进JS别当数字传
前端·electron
涛涛ing36 分钟前
AI帮我生成了一个炫酷的3D大屏,上线3天就卡崩了
前端
jerrywus1 小时前
用 AMD Radeon Cloud 免费跑 ComfyUI:从开机到打开界面
前端·agent·claude
学以智用1 小时前
CKEditor5 完整详解
前端·后端
掘金者阿豪1 小时前
数据库性能优化:一次慢查询背后,可能不只是SQL的问题
前端·后端
deli0073 小时前
锁过期了业务还没跑完:SETNX 分布式锁 1000 次并发实测
前端
不一样的少年_3 小时前
用了这 Skill,我觉得前端兄弟可以毕业了
前端·后端·agent
FRing034 小时前
vue2干货总结10(json-server、vant-ui、postcss插件、axios二次封装、图形验证码、toast轻提示)
开发语言·前端·vue.js·ui·json·vue2·postcss
梦想很大很大4 小时前
一句“你好”用了 5671 Token:我在 Workrun 中追查 Agent 隐性成本的过程
前端·人工智能·后端