Playwright 自动化测试系列(7)| 第三阶段:测试框架集成PO模式
一、Page Object 模式的核心价值
1. 问题驱动
传统测试脚本将元素定位与操作逻辑混写在用例中，导致：
- 维护灾难：页面元素变动需修改所有相关用例（如登录按钮ID变更需全局搜索替换）
- 复用困难：相同操作逻辑无法跨用例共享（如登录流程重复编写）
- 可读性差：业务逻辑被技术细节淹没（如page.locator("#login-btn").click()分散在多个步骤）
2. 解决方案
Page Object（PO）模式将页面抽象为类：
- 元素定位器 → 封装为类属性
- 操作行为 → 封装为类方法
- 业务流 → 通过方法组合实现
# 传统模式 vs PO模式对比
# 传统：元素定位与操作耦合
page.locator("#username").fill("user1")
page.locator("#password").fill("pass1")
page.locator("#login-btn").click()
# PO模式：业务语义化
login_page.enter_username("user1")
login_page.enter_password("pass1")
login_page.click_login()
二、电商全流程PO架构设计
1. 系统分层架构
2. 核心类设计
类名 | 职责 | 关键方法举例 |
LoginPage | 登录页面操作封装 | enter_credentials() , submit() |
HomePage | 首页导航与搜索 | search_product() , view_cart() |
ProductPage | 商品详情操作 | select_color() , add_to_cart() |
CartPage | 购物车管理 | apply_coupon() , checkout() |
OrderPage | 订单结算流程 | fill_address() , confirm_pay() |
三、实战：电商登录-下单PO封装
1. 登录页封装（LoginPage）
class LoginPage:
def __init__(self, page):
self.page = page
self.username_input = page.get_by_placeholder("手机号/邮箱") # 使用面向用户定位器
self.password_input = page.get_by_label("密码")
self.submit_btn = page.get_by_role("button", name="登录")
def navigate_to_login(self):
self.page.goto("https://mall.example.com/login")
def enter_credentials(self, username, password):
self.username_input.fill(username)
self.password_input.fill(password)
def submit(self):
self.submit_btn.click()
self.page.wait_for_url("**/dashboard") # 显式等待导航完成
2. 购物车页封装（CartPage）
class CartPage:
def __init__(self, page):
self.page = page
self.coupon_field = page.locator("[data-testid='coupon-input']") # 测试ID定位增强稳定性
self.apply_btn = page.get_by_text("应用优惠券")
def apply_coupon(self, code: str):
self.coupon_field.fill(code)
self.apply_btn.click()
expect(self.page.get_by_text("优惠券已生效")).to_be_visible() # 自动等待 + 断言
def checkout(self):
self.page.get_by_role("button", name="结算").click()
3. 业务流组合（测试用例层）
def test_e2e_order(login_page, home_page, cart_page):
# 登录 → 搜索 → 加购 → 结算
login_page.navigate_to_login()
login_page.enter_credentials("user1", "securePass123")
login_page.submit()
home_page.search_product("无线耳机")
home_page.select_first_product()
product_page.add_to_cart(quantity=2)
cart_page.apply_coupon("FESTIVAL2025")
cart_page.checkout()
order_page.confirm_payment()
assert order_page.get_order_status() == "支付成功"
四、PO模式高级技巧
1. 复合操作封装
避免原子操作暴露，直接提供业务接口：
# 反例：调用方需知道操作细节
login_page.enter_username("user1")
login_page.enter_password("pass1")
login_page.click_login()
# 正例：业务语义封装
login_page.login_with("user1", "pass1")
2. 动态元素处理
使用Playwright的Locator API处理动态生成元素：
def get_product_element(self, name):
return self.page.locator(f".product-item:has-text('{name}')") # 文本+CSS组合定位
3. 多层级PO复用
通过页面嵌套实现复杂组件复用：
class HeaderComponent:
def __init__(self, page):
self.search_bar = page.get_by_role("searchbox")
def search(self, keyword):
self.search_bar.fill(keyword)
self.search_bar.press("Enter")
class HomePage:
def __init__(self, page):
self.page = page
self.header = HeaderComponent(page) # 复用头部组件
五、Pytest集成与多用户测试
1. 测试隔离设计
利用Playwright的browser.new_context()实现用户会话隔离：
# conftest.py
@pytest.fixture(scope="function")
def user_context(playwright):
browser = playwright.chromium.launch()
context = browser.new_context(storage_state="user1_session.json") # 复用登录态
yield context
context.close()
2. 多用户并发测试
模拟用户并发抢购场景：
def test_concurrent_purchase(user_context_factory):
with ThreadPoolExecutor() as executor:
# 启动3个并发用户
futures = [
executor.submit(run_user_flow, user_context_factory("user1")),
executor.submit(run_user_flow, user_context_factory("user2")),
executor.submit(run_user_flow, user_context_factory("user3"))
]
results = [f.result() for f in futures]
assert all("下单成功" in r for r in results)
六、常见问题解决方案
问题场景 | 根因 | PO模式解决方案 |
元素定位失效 | 页面结构调整或属性变更 | 集中维护定位器，修改仅影响PO类 |
异步加载导致操作失败 | 元素未就绪 | PO方法内封装wait_for_selector |
跨页面依赖管理复杂 | 页面跳转状态传递丢失 | 返回新页面对象（return OrderPage(self.page)） |
多语言版本兼容性差 | 文本定位器硬编码 | 抽取文本资源到独立配置文件 |
七、总结：PO模式的核心收益
- 可维护性：页面变更只需修改对应PO类，不影响200+测试用例
- 可读性：用例清晰表达业务意图（login_page.login_with() vs 5行定位代码）
- 复用性：购物车操作复用率达90%（加购/改数量/结算等）
- 扩展性：通过组件化设计支持新页面快速接入
终极实践建议：
原子操作 → 封装在PO方法内
业务流程 → 组合PO方法实现
验证逻辑 → 通过expect断言集成
环境隔离 → 善用browser.new_context()
通过本实战，可构建日均执行5000+用例的电商测试框架，缺陷捕捉率提升40%，维护成本降低70%。