""" BasePage - Page Object 基类(重构版) 使用 Mixin 模式实现职责分离,遵循单一职责原则。 特性: - 防挂起守卫机制(避免元素不存在时长时间等待) - 智能等待策略(条件等待、布尔返回) - 统一的超时管理 - 多种语义化定位方法 - 模块化的功能拆分 Mixin 组成(12 个): - NavigationMixin: 导航相关 - LocatorMixin: 元素定位 - WaitMixin: 等待策略 - InteractionMixin: 交互操作 - AssertionMixin: 断言方法 - StateMixin: 状态检查 - TableMixin: 表格操作 - PaginationMixin: 分页操作 - SearchMixin: 搜索操作 - UtilityMixin: 工具方法 - SmartLocatorMixin: 语义化智能定位器(Robogo 兼容) - SmartInteractionMixin: 语义化智能交互(Robogo 兼容) """ from playwright.sync_api import Page from config.settings import config from tests.logger import log_ui from tests.base.mixins import ( NavigationMixin, LocatorMixin, WaitMixin, InteractionMixin, AssertionMixin, StateMixin, TableMixin, PaginationMixin, SearchMixin, UtilityMixin, SmartLocatorMixin, SmartInteractionMixin, ) class BasePage( NavigationMixin, LocatorMixin, WaitMixin, InteractionMixin, AssertionMixin, StateMixin, TableMixin, PaginationMixin, SearchMixin, UtilityMixin, SmartLocatorMixin, SmartInteractionMixin, ): """ Page Object 基类 通过多继承 Mixin 实现功能组合,保持核心逻辑简洁。 所有页面对象应继承此类。 """ def __init__(self, page: Page): """初始化页面对象 Args: page: Playwright Page 对象 """ self.page = page self.timeout = config.DEFAULT_TIMEOUT self.base_url = config.BASE_URL.rstrip("/") self.config = config # 子类应定义 url 属性 # self.url = "/module/path" # ==================== 内部方法 ==================== def _safe_wait_network_idle(self, timeout: int = 10000) -> None: """安全等待 networkidle,超时不抛异常。""" try: self.page.wait_for_load_state("networkidle", timeout=timeout) except Exception: pass def _log_debug(self, message: str) -> None: """内部日志方法""" log_ui.debug(message)