TBC/tests/base/mixins/interaction.py
d-robotics 633a797226 AutoFlow v2.0: 合并 Test (Robogo) + data-loop-automation (D-Cloud) 为统一平台
- 16 个业务模块,856 个测试用例,40 个 E2E 测试
- 单一 React 19 前端 + PlatformSwitcher 二合一切换
- Flask 后端支持 scenario/dcloud_module/dcloud_e2e/dcloud_all 四种任务类型
- E2E 测试面板:API 全链路(8条) + UI 点击(3条) + 分步测试(3个)
- SSE 实时日志流 + 飞书告警 + 定时调度
- 完整还原原 ToB 平台 TestPanel E2E 模块
2026-06-23 11:48:29 +08:00

127 lines
3.8 KiB
Python

"""交互操作 Mixin"""
class InteractionMixin:
"""交互操作相关
提供点击、输入、选择等用户交互方法。
"""
def click(self, selector: str) -> None:
"""点击元素(自动等待可见)
Args:
selector: 元素选择器
"""
self.wait_for_element(selector, state="visible")
self._log_debug(f"[点击] {selector}")
self.page.locator(selector).click(timeout=self.timeout)
def click_if_visible(self, selector: str, timeout: int = 5000) -> bool:
"""防挂起点击:仅在元素可见时点击
Args:
selector: 元素选择器
timeout: 等待超时(毫秒)
Returns:
bool: 是否成功点击
"""
locator = self.find(selector)
try:
locator.wait_for(state="visible", timeout=timeout)
locator.click()
self._log_debug(f"[点击成功] {selector}")
return True
except Exception:
self._log_debug(f"[元素不可见,跳过点击] {selector}")
return False
def fill(self, selector: str, value: str) -> None:
"""填充输入框
Args:
selector: 元素选择器
value: 填充值
"""
self.wait_for_element(selector, state="visible")
self._log_debug(f"[输入] {selector} = '{value}'")
self.page.locator(selector).fill(value, timeout=self.timeout)
def type(self, selector: str, text: str, delay: int = 0) -> None:
"""逐字输入
Args:
selector: 元素选择器
text: 输入文本
delay: 每个字符间延迟(毫秒)
"""
self.wait_for_element(selector, state="visible")
self.page.locator(selector).type(text, delay=delay)
def clear(self, selector: str) -> None:
"""清空输入框
Args:
selector: 元素选择器
"""
self.wait_for_element(selector, state="visible")
self.page.locator(selector).clear()
def click_and_wait(self, selector: str, wait_for: str = None) -> None:
"""点击并等待
Args:
selector: 要点击的元素选择器
wait_for: 等待出现的元素选择器(可选)
"""
self.click(selector)
if wait_for:
self.wait_for_element(wait_for)
else:
self.wait_for_page_ready()
def fill_and_wait(self, selector: str, value: str, wait_for: str = None) -> None:
"""填充并等待
Args:
selector: 输入框选择器
value: 填充值
wait_for: 等待出现的元素选择器(可选)
"""
self.fill(selector, value)
if wait_for:
self.wait_for_element(wait_for)
def select_option(self, selector: str, value: str) -> None:
"""选择下拉选项
Args:
selector: 下拉框选择器
value: 选项值
"""
self.wait_for_element(selector, state="visible")
self.page.locator(selector).select_option(value)
def check(self, selector: str) -> None:
"""勾选复选框
Args:
selector: 复选框选择器
"""
self.wait_for_element(selector, state="visible")
self.page.locator(selector).check()
def uncheck(self, selector: str) -> None:
"""取消勾选复选框
Args:
selector: 复选框选择器
"""
self.wait_for_element(selector, state="visible")
self.page.locator(selector).uncheck()
def _log_debug(self, message: str) -> None:
"""内部日志方法,由 BasePage 提供实现"""
pass