配套工程源码、测试材料与运行说明

收到 A 到 F,业务最后拿到什么

点一次「重放六次触发」之前,先把答案写下来:原始轨应该有 A 到 F,节流轨留下 A、D、F,防抖轨留下 C、E、F。两条规则都写了 450 ms,面对同一批输入却保留了不同的检票记录。六张票分成三组,不用等读完代码才判断有没有跑对。页面还留着整条原始记录,如果少了一张,可以先去找输入和定时器,免得把漏掉的事件误认成已经过滤。

从 A 到 F 的时间表

重放数组里有六个时间点,0、150、300、1100、1250、2100 毫秒。它们对应 A 到 F。A、B、C 挤在最前面,中间隔了一段再来 D、E,F 自己在最后。演示把输入间隔设得离 450 的边界远一些,给真实定时器的少量抖动留了空间。第一组的首票预期为 A,尾票为 C。第二组应留下 D 和 E,最后一组两边都应留下 F。

原始轨是另外一份证据。自动脚本启动重放,检测六张原票、三张首票、三张尾票。清空后读到三列都为零,再单独按一次,三列都看到一张,随后重放得到原先的结果。保留第一列是因为它能发现「事件压根没进来」。若重放漏了两次,后两列看上去也可能都很干净,那不是滤得好。

把起点写成一条展开记录更容易跟。到 0 毫秒,A 进入原始轨与首票轨,同时预约它作为尾票。到 150,B 仍进入原始轨,首票因离 A 太近拒绝 B,尾票改等 B。300 进入 C 时操作同样,下一次 450 毫秒空窗才终于写下 C。D、E 相隔 150,分别留下首、尾。F 跟前一组隔很久,两列都需要留它。脚本的判定记录了三列数量,字母顺序来自样例固定输入与三个轨道的显示。若改成通用组件,把标签也纳入断言,首尾都为三才不会把选错票漏掉。

让 receive() 同时跑两套账

const now = systemDateTime.getUptime(systemDateTime.TimeType.STARTUP);
this.raw = [...this.raw, label];
if (this.acceptedAt < 0 || now - this.acceptedAt >= WINDOW_MS) {
  this.acceptedAt = now;
  this.first = [...this.first, label];
}

按钮不是直接进入两个独立收集器。原始输入先进入 receive,读同一时刻再分别更新首票和尾票。这说明两条路径比较有同一批输入。代码在末尾通过新数组更新状态,这让诊断图明确反映每次增加;对于真正每帧有输入的应用,生产状态不必逐条复制和刷新这么长的历史。可以用受控队列或更轻的测试观测,保证统计入口仍然可复核。若有时钟跳变,按这里的系统启动计时源计算经过时间,避免使用日期时钟导致回拨后很长时间进不了首票。

receive 先把每次输入放到原始数组,再看上一个被接受的时间。acceptedAt 初始是负数,第一张直接进。A 进来以后,B 与 C 即使来过,也不能修改 acceptedAt。假如 B 被拒时仍将它写成最后接受时刻,往后连续按住就会一直推迟窗口。程序就会悄悄偏离原来的「每到一个新的放行窗口收第一张」。

这段比较用经过时间,等于 450 毫秒时符合大于等于就能进。时间戳两侧有两个观测位,一边记录原始到达,一边记录接受动作。如果你拿这份逻辑接「保存」按钮,还应另问业务是否允许一段时间后重复保存。节流只能限制入口频次,数据库或服务端要避免重复写时,应有自己的请求身份和幂等处理。用同一把锁包住两件事,重试时就难解释到底哪次已经提交。

尾票不看刚才放行了谁

从画面看,尾票在 A 到达时不应立刻出现。程序先记「入口记录」,安排尾票后才返回,等下一轮输入再决定是否撤销它。这里用两个相隔较远的事件区分代码有没有真的延后执行:若 F 一来尾票就亮,检查 setTimeout 是不是传了一个已经执行完的调用结果。若 F 出现后一直没有尾票,则回看 pending 有没有在本轮其他入口被意外清掉。

if (this.pending >= 0) clearTimeout(this.pending);
this.pending = setTimeout(() => {
  this.pending = -1;
  this.last = [...this.last, label];
}, WINDOW_MS);

任一输入到来后,撤掉上一张等待中的尾票,再给现在的标签开一份定时任务。A 的任务预期在 450 到期,但 B 在 150 到达会撤掉它,C 在 300 再撤掉 B。若之后安静,到约 750 毫秒才记录 C。F 没人接在它后面,会自然存入最后一列。闭包持有的是这张票的 label。如果把它换成可以被别的输入处修改的全局字符串,测试中还要单独确认晚执行的回调看的是谁。

输入法和粘贴也值得分别试。组字期间的文字还没提交,可以等组合结束再开始计时。搜索框被清空时可取消待办并立即清结果。粘贴整段后马上按回车,若业务希望立即提交,那次回车也要撤销旧的尾票,免得先出现一份结果,几百毫秒后又收到一次相同操作。检票台保留的是事件编号,移到真实搜索可把文字来源和请求身份一起记下。

搜索输入常用这种写法,但结果可能晚于下一次输入。防抖只能撤销还在等待的调用。如果 C 已经触发网络,之后又输入 D,C 的响应仍可能后到。业务可以在发送时保存一个请求版本,并在写回之前核对它是否还代表用户现在输入的字。定时器和正在运行的网络请求是两层问题,手动复测应分别安排等待中取消一次、请求已经发出以后换词一次。

清空按钮为什么要清两类定时器

aboutToDisappear(): void {
  this.cancelTimers();
}

private cancelTimers(): void {
  this.scheduled.forEach((id: number) => clearTimeout(id));
  this.scheduled = [];
  if (this.pending >= 0) {
    clearTimeout(this.pending);
    this.pending = -1;
  }
}

按钮不是只清三列数组。重放函数先后安排了六个输入和一次结束,还有 receive 单独创建的尾票计时。scheduled 管理前一批,pending 管当前还没放行的尾票。不一起清掉,用户刚清完看到零,晚来的票又会自己出现。同样的取消操作也在离开页面触发,防止定时任务在 UI 消失后继续写状态。

做这类测试可以在 A 刚过、C 的尾票还没出现时直接清空,等待超过最后一张的计划时间,整个过程中不应冒出旧票。然后再按一个手动输入,应该正常留下三份记录。保留第二步是为了区分「已取消旧行」和「把页面永久锁住」。当前自动复测覆盖了完整重放、清空与手动重来;在业务工程里,可以按实际控制入口把中途取消也加为单独用例。

点「重放六次触发」和「手动加一张」

打开文首工程,用 API 24 SDK 运行 entry。等「记录中…」结束再数三栏,预期为 6、3、3。随后点「清空」,确认三条轨道都归零,再手动加一张。首票应立即显示,尾票等一个 450 ms 窗口才出现。这个应用用 ArkUI 的按钮事件发出输入,处理计时用 setTimeout 和 clearTimeout,没有额外依赖。自动复测可以直接找 pulse-raw、pulse-first 和 pulse-last 三个节点,避免用主题颜色判断结果。

import { systemDateTime } from '@kit.BasicServicesKit';



const WINDOW_MS: number = 450;

const PULSES: number[] = [0, 150, 300, 1100, 1250, 2100];

const LABELS: string[] = ['A', 'B', 'C', 'D', 'E', 'F'];



@Component

struct TicketStrip {

  @Prop name: string = '';

  @Prop subtitle: string = '';

  @Prop values: string[] = [];

  @Prop color: string = '';

  @Prop countId: string = '';



  build() {

    Column({ space: 11 }) {

      Row() {

        Text(this.name).fontWeight(FontWeight.Bold).fontSize(22).fontColor('#2E1B16')

        Blank()

        Text(this.subtitle).fontSize(13).fontColor('#6B5145')

      }.width('100%')

      Row({ space: 9 }) {

        ForEach(LABELS, (label: string) => {

          Text(label).fontSize(20).fontWeight(FontWeight.Bold)

            .width(47).height(47).textAlign(TextAlign.Center)

            .fontColor(this.values.includes(label) ? '#FFF8EC' : '#674A39')

            .backgroundColor(this.values.includes(label) ? this.color : '#EADCCC')

            .borderRadius(24)

        }, (label: string) => label)

        Blank()

        Text(this.values.length.toString()).id(this.countId).fontSize(29).fontWeight(FontWeight.Bold).fontColor(this.color)

      }.width('100%')

    }.width('100%').alignItems(HorizontalAlign.Start).padding({ top: 17, bottom: 17 })

    .border({ width: { bottom: 1 }, color: '#D9C8B7' })

  }



}



@Entry

@Component

struct Index {

  @State raw: string[] = [];

  @State first: string[] = [];

  @State last: string[] = [];

  @State running: boolean = false;

  private acceptedAt: number = -1;

  private pending: number = -1;

  private scheduled: number[] = [];



  aboutToDisappear(): void {

    this.cancelTimers();

  }



  private cancelTimers(): void {

    this.scheduled.forEach((id: number) => clearTimeout(id));

    this.scheduled = [];

    if (this.pending >= 0) {

      clearTimeout(this.pending);

      this.pending = -1;

    }

  }



  private receive(label: string): void {

    const now = systemDateTime.getUptime(systemDateTime.TimeType.STARTUP);

    this.raw = [...this.raw, label];

    if (this.acceptedAt < 0 || now - this.acceptedAt >= WINDOW_MS) {

      this.acceptedAt = now;

      this.first = [...this.first, label];

    }

    if (this.pending >= 0) clearTimeout(this.pending);

    this.pending = setTimeout(() => {

      this.pending = -1;

      this.last = [...this.last, label];

    }, WINDOW_MS);

  }



  private clearBoard(): void {

    this.cancelTimers();

    this.acceptedAt = -1;

    this.raw = [];

    this.first = [];

    this.last = [];

    this.running = false;

  }



  private replay(): void {

    this.clearBoard();

    this.running = true;

    this.scheduled = PULSES.map((delay: number, index: number): number =>

      setTimeout(() => this.receive(LABELS[index]), delay));

    this.scheduled.push(setTimeout(() => {

      this.running = false;

      this.scheduled = [];

    }, 2720));

  }





  build() {

    Scroll() {

      Column() {

        Row() {

          Column({ space: 4 }) {

            Text('检票节拍器').fontSize(42).fontWeight(FontWeight.Bold).fontColor('#FFF4E5')

            Text('三连击 · 双击 · 单击').fontSize(16).fontColor('#F5C9A8')

          }.alignItems(HorizontalAlign.Start).layoutWeight(1)

          Text('450\n毫秒').fontSize(22).fontWeight(FontWeight.Bold).textAlign(TextAlign.Center)

            .fontColor('#3E2317').backgroundColor('#F8C674').width(96).height(80).borderRadius(18)

        }.width('100%').padding(24).backgroundColor('#7B2F23')

        Column({ space: 7 }) {

          TicketStrip({ name: '入口记录', subtitle: '每次触发都记', values: this.raw, color: '#644022', countId: 'pulse-raw' })

          TicketStrip({ name: '节流', subtitle: '窗口内只接第一张', values: this.first, color: '#9D3824', countId: 'pulse-first' })

          TicketStrip({ name: '防抖', subtitle: '安静后只接最后一张', values: this.last, color: '#2D5C4E', countId: 'pulse-last' })

          Row({ space: 16 }) {

            Button('重放六次触发').id('pulse-play').onClick(() => this.replay())

              .backgroundColor('#7B2F23').fontColor('#FFF8EC')

            Button('手动加一张').id('pulse-hand').enabled(!this.running && this.raw.length < 6)

              .onClick(() => this.receive(LABELS[this.raw.length]))

              .backgroundColor('#2D5C4E').fontColor('#FFF8EC')

            Button('清空').id('pulse-reset').onClick(() => this.clearBoard())

              .backgroundColor('#EADCCC').fontColor('#382720')

          }.width('100%').margin({ top: 14 })

          Text(this.running ? '记录中…' : '可以手动点,也可以重放同一段节奏')

            .id('pulse-status').fontSize(14).fontColor('#6B5145').width('100%')

        }.width('100%').padding({ left: 24, right: 24, bottom: 24 }).backgroundColor('#FFF7E9')

      }.width('92%').constraintSize({ maxWidth: 780 })

    }.width('100%').height('100%').align(Alignment.Top).padding({ top: 22 }).backgroundColor('#E8D8C6')

  }

}

代码里点击单次输入时按当前原始数组长度选标签,这使清空以后第一张又回到 A。手动测试若不先点清空,紧接着加入的标签可能不是你预期的第一张,这属于测试起点变化。重放先调用 clearBoard,再创建定时任务,所以不依赖前一轮还留下多少票。接业务时可以把这两类动作设计得更清楚:清空是用户取消过去的一组,单次输入是传一个新事件。不要把演示的标签数组当成编号生成器。如果手动输入使用了真实文本或任务 ID,让回调捕获完整的当前值,并在尾回调执行前确认它没有因页面状态变动而失效。这样重放不只看 A 到 F,也能直接拿真实输入复验。

当前手动按钮还有一个六张上限,因为演示只准备了 A 到 F 六个标签。满六张后按不出新票,是标签用完了,和 450 毫秒内是否放行没有关系。想单独验证时间窗时,先用清空恢复到第一张,再连按两次,分别看入口栏有没有第二张,以及首票、尾票各保留哪一个。

FAQ

怎么在工具里直观看到最后一张「晚到」? 先装入 API 24 的 MateBook Pro 镜像,运行版本 6.1.0.125(SP12DEVC00E47R1P3),把完整文件放到默认 Stage 页面。打开后先点重放,暂停鼠标,等三行都稳定。屏幕先能看出原始列越来越长,尾票要等各组结束。清空后马上确认 0、0、0,再点一次手动加票并等过 450 毫秒,读到 1、1、1。最后再重放,验证 6、3、3 回来。清空和重放都应从同一个按钮作用域开始,如果按了其它入口,也要记下是否额外增加一张原始票。

若需求其实是首尾全发呢? 可以保留每组第一次,再为同一组的尾部独立安排一次,但要定义只有一张时发一次还是两次。当前示例把它们画成两列,所以同一张 F 可以同时出现在两个观测数组。产品若把两条回调都接到一次提交动作,F 就可能重复执行。组合前先定下业务键和是否需要去重,并用只有单个输入、两次很快的输入和跨过窗口的两次输入三组条件复现。

为什么同一时间窗出现三张票总数,一样多还要两种? 这里两种结果条数都等于三,但 A 与 C、D 与 E 不同。使用场景关心的是选中哪一张。波形改成间隔均匀的输入后,节流与防抖的数量也可以不同。测试用例应同时记录票的标签和出现顺序,经常有人只写断言数组长度而看不出这一点。

把时间窗设到零能快速验证吗? 会失去区分这两个语义的样本。应该保持被测窗口,在测试里给出明确的相邻输入间隔。想做靠近边界的用例,可给计时函数一个可控的时钟,或者用系统采集确认实际到达时间。计划的 450 毫秒不等于现场实际刚好相等。

重放时到底哪个按钮被挡住? 源码把 running 接到「手动加一张」的启用条件,重放按钮仍可再按。再次按重放会先 clearBoard,取消旧的安排再开新一轮。「清空」也仍可按。这是三个入口各做不同的事,不能从手动按钮临时变灰就断言重放不可再次触发。

另一种用例能专门验证首票。B 落在 A 的窗口内,C 落在 A 的窗口外,但与 B 还不到一个等待窗口。预期首票有 A 和 C,尾票可能只有 C。这样的输入更容易辨认有人不小心在 B 被拒时也更新了 acceptedAt。保存原始时间与接受时间两列,之后修改窗口参数就能明确是哪一条规则变了。

测试窗口边缘不要只靠肉眼掐。系统一般按可执行时机触发计划任务,显示器、线程调度或后台切换会造成误差。希望测试等于边界的比较符,可以先用可控的时钟测试纯判断,再到模拟器用离边界更远的时间检查真实交互。定时器在后台恢复之后如果全部集中执行,还应按业务约束处理历史输入,比如恢复后仅保留最新搜索条件。录图这轮重放发生在前台,自动化读数不替代后台恢复测试。

有时页面同时放着两个独立入口,比如按商品名搜索和按仓位筛选。若共用一个 pending,改仓位会撤销仍需要的商品名操作。可以分别保存各自的待办,或者把两项合成一个明确的筛选操作。选择取决于业务想提交的是两份事件还是同一份组合条件。

总结

首票看上次放行,尾票等最后一次到达。先留原始票根证实输入齐全,再看业务拿到了哪几张。重放与清空一并验证,计时规则便不容易被跨轮回调悄悄改变。

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐