"""交互操作 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