TBC/tests/base/base_page.py
jiawei.chen 6f6053ff51 feat: TestAgent 智能测试平台 v1.0
- CLI + Web 双平台,基于 LLM 的 TDD+DDD 自动化测试生成
- 集成 unified-test-platform 903 个 D-Cloud 用例 + 13 个 Robogo 场景
- Agent 5 步流水线: 扫描 -> DDD -> LLM 生成测试
- 精确回归 + UI 变更检查
- 可视化 HTML 测试报告
- 暗色/亮色主题切换
- 19 个 API 端点 + 6 个 SPA 页面
- 15/15 项 TDD+DDD 合规
2026-07-08 11:27:38 +08:00

93 lines
2.3 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

"""
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)