循环与条件

DSL 提供 3 种控制流 action:repeat / forEach / ifExists。

repeat — 固定次数循环

- repeat:
    times: 5
    steps:
      - scroll: down
      - wait: 500

典型用途:

• 滚动加载列表(scroll N 次)
• 批量点击
• 压测(跑 N 遍同一个 flow 看稳定性)

forEach — 遍历

静态 list

- forEach:
    var: TAB
    values: [Home, Search, Profile, Settings]
    steps:
      - tap: "${TAB}"
      - wait: 1500
      - saveScreenshot: "tab-${TAB}"

文件驱动(CSV / JSON)

- forEach:
    var: U
    from: ./users.csv   # 相对 YAML 目录
    steps:
      - input: "${U.email}"
      - input: "${U.password}"
      - tap: Login

CSV 格式(第一行表头):

email,password,expected_plan
alice@x.com,pw1,pro
bob@x.com,pw2,free

JSON 格式(array of string 或 object):

[
  { "email": "alice@x.com", "password": "pw1" },
  { "email": "bob@x.com", "password": "pw2" }
]

规则:

• 每次迭代 ${var} 或 ${var.field} 替换成当前行
• 迭代结束自动清理变量,不影响后续 step
• values 和 from 二选一

见 变量与 Include 的运行时机制。

ifExists — 条件分支

- ifExists:
    pattern: 欢迎回来      # 屏上存在这个文字?
    then:
      - tap: 进入
    else:
      - tap: 注册
      - input: "${EMAIL}"

典型用途:

• 处理首次登录 vs 已登录
• 弹窗可能出现也可能不出现(比 dismissModal 更精细)
• A/B 版本不同 UI 路径

pattern 是子串匹配(不是正则);想用正则目前 ifExists 不支持,可以先 readText 存变量再手动判断。

组合:轮询 + 分支

# 等内容加载,然后根据结果走不同分支
- tap: 提交订单
- waitFor: { pattern: 处理中, timeoutMs: 30000 }
- waitAbsent: { pattern: 处理中, timeoutMs: 30000 }

- ifExists:
    pattern: 支付成功
    then:
      - saveScreenshot: paid-ok
      - assert: 订单号
    else:
      - readText: { label: 错误提示, into: ERR }
      - saveScreenshot: paid-fail
      - assertVisual: "显示支付失败原因 ${ERR}"

嵌套

repeat / forEach / ifExists 的 steps 里可以再嵌任意 step,包括彼此。

- forEach:
    var: USER
    from: ./users.csv
    steps:
      - input: "${USER.email}"
      - tap: Login
      - ifExists:
          pattern: 需要二次验证
          then:
            - readText: { regex: "(\\d{6})", into: OTP }
            - input: "${OTP}"
          else: []    # 没启用 2FA,跳过
      - assert: Dashboard
      - tap: Logout

失败处理

DSL 执行顺序式:某一步失败 → 后续 step 不跑,整个测试标记 FAIL。

• ifExists 的 then / else 里如果某 step 失败,整个任务失败(不会回到外层继续)
• forEach 某一轮失败,不会跑剩余迭代(早退出)
• 想"失败容忍"或"重试"当前不支持,future 可能加 try / onFail

如果你的用例需要严格容错,在 AI solver(非 DSL)里更灵活。

不支持的控制流(未来)

特性	为什么暂不支持	临时方案
while 通用循环	脆弱,容易死循环	用 repeat + ifExists 早退
try/catch	DSL 设计追求"简单 + 可审查"	代码级 scripted solver 写 TS 实现
函数 / 自定义 step	同上	用 include 提取共用 steps
并行 steps	单设备 UI 天然不能并行	多设备并行 runner 级别已有

相关

• 动作列表
• 变量与 Include