AsyncTest

Appearance

获取主用例下标 ​

什么是主用例下标？ ​

主用例下标是当前主用例在循环执行中的 当前迭代位置（从 0 开始）。

无论当前步骤被嵌套在哪个子用例中，at.get_main_case_index() 始终返回的是主用例当前循环的下标。

基本用法 ​

python
index = at.get_main_case_index()
print(f"主用例当前下标: {index}")

返回值： 整数，主用例当前循环的下标（从 0 开始）

示例 ​

主用例中直接调用 ​

python
index = at.get_main_case_index()
# 第 1 次循环: 0
# 第 2 次循环: 1
# 第 3 次循环: 2

在嵌套子用例中调用 ​

即使当前步骤处于子用例中，返回的仍然是主用例的下标：

python
# 假设主用例循环 3 次，当前处于第 2 次循环中的某个子用例
index = at.get_main_case_index()
# 返回: 1（主用例第 2 次循环的下标）

使用场景 ​

根据循环次数执行不同逻辑 ​

python
index = at.get_main_case_index()

if index == 0:
    # 第一次循环：初始化操作
    at.temp.set("action", "create")
elif index == 1:
    # 第二次循环：更新操作
    at.temp.set("action", "update")
else:
    # 后续循环：删除操作
    at.temp.set("action", "delete")

结合数据驱动 ​

python
index = at.get_main_case_index()
print(f"当前正在执行第 {index + 1} 组测试数据")

日志记录 ​

python
index = at.get_main_case_index()
print(f"[主用例 #{index + 1}] 开始执行")

注意事项 ​

  • at.get_main_case_index() 是同步方法，无需 await
  • 下标从 0 开始
  • 无论嵌套多深，始终返回主用例的循环下标
  • 此方法仅在用例执行上下文中有效

总结 ​

主用例下标提供了当前主用例循环进度的精确定位：

  • 通过 at.get_main_case_index() 获取
  • 不受子用例嵌套影响，始终指向主用例
  • 适合用于循环控制、数据驱动、日志记录等场景