93 lines
2.3 KiB
Python
93 lines
2.3 KiB
Python
"""
|
||
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)
|