1. 为什么选择Playwright框架如果你正在寻找一款现代化的自动化测试工具Playwright绝对值得你花时间了解。我第一次接触Playwright是在去年重构公司测试框架时当时我们团队还在使用Selenium遇到了不少头疼的问题。比如测试执行速度慢、跨浏览器兼容性差、需要手动处理各种等待逻辑等等。而Playwright的出现完美解决了这些痛点。Playwright最吸引我的几个特点多浏览器支持Chromium、Firefox和WebKit三大浏览器引擎原生支持API行为完全一致智能等待机制自动等待元素可用再也不用写sleep(10)这种丑陋的代码了超快的执行速度比传统方案快2-3倍特别是在CI/CD环境中表现突出强大的网络控制可以拦截和修改网络请求模拟各种网络条件内置录制功能不需要从零开始写代码录制操作就能生成测试脚本我特别喜欢它的自动等待机制。以前用Selenium时经常因为元素加载时间不一致导致测试失败不得不添加各种显式等待。而Playwright会自动等待元素出现在DOM中并且可交互大大提高了测试的稳定性。2. 快速安装与环境配置2.1 基础安装步骤安装Playwright非常简单只需要两个命令。我建议先创建一个干净的Python虚拟环境避免与其他项目产生依赖冲突。# 创建虚拟环境可选但推荐 python -m venv playwright-env source playwright-env/bin/activate # Linux/Mac playwright-env\Scripts\activate # Windows # 安装Playwright Python包 pip install playwright # 安装浏览器二进制文件 playwright install这里有个小技巧如果你只需要测试特定浏览器可以只安装对应的二进制文件节省磁盘空间。比如playwright install chromium # 只安装Chromium2.2 验证安装安装完成后我习惯写个简单的测试脚本来验证环境是否正常from playwright.sync_api import sync_playwright with sync_playwright() as p: browser p.chromium.launch(headlessFalse) page browser.new_page() page.goto(https://www.baidu.com) print(page.title()) browser.close()如果能看到浏览器打开并打印出百度一下你就知道说明环境配置成功了。3. 核心API与基础用法3.1 浏览器与页面控制Playwright的API设计非常直观。最基本的操作流程是启动浏览器 → 创建页面 → 执行操作。下面是一个完整示例from playwright.sync_api import sync_playwright def test_basic_operations(): with sync_playwright() as p: # 启动浏览器设置headlessFalse可以看到浏览器界面 browser p.chromium.launch(headlessFalse) # 创建新页面 page browser.new_page() # 导航到目标网址 page.goto(https://www.baidu.com) # 获取页面标题 print(f当前页面标题: {page.title()}) # 页面截图 page.screenshot(pathscreenshot.png) # 关闭浏览器 browser.close()在实际项目中我更喜欢使用上下文(context)来管理多个页面with sync_playwright() as p: browser p.chromium.launch() context browser.new_context() # 创建多个页面 page1 context.new_page() page2 context.new_page() # 每个页面独立操作 page1.goto(https://www.baidu.com) page2.goto(https://www.taobao.com) context.close()3.2 元素定位与操作Playwright提供了多种元素定位方式我最常用的是CSS选择器和XPath# CSS选择器 page.locator(input#kw).fill(Playwright) # XPath page.locator(//input[idkw]).click() # 文本定位 page.locator(text百度一下).click()对于表单操作Playwright的API非常人性化# 输入文本 page.locator(#kw).fill(自动化测试) # 清空输入 page.locator(#kw).clear() # 勾选复选框 page.locator(#remember-me).check() # 选择下拉选项 page.locator(#city).select_option(北京)4. 高级功能实战4.1 处理iframe和弹窗iframe是自动化测试中的常见难点。Playwright处理iframe非常简单# 通过name属性定位iframe frame page.frame(namelogin_frame) # 在iframe内操作元素 frame.locator(#username).fill(testuser) # 处理弹窗 page.on(dialog, lambda dialog: dialog.accept()) page.locator(#show-dialog).click()4.2 网络请求拦截这个功能在测试中非常有用可以模拟各种网络场景# 拦截所有请求 page.route(**/*, lambda route: route.continue_()) # 修改请求 page.route(**/api/user, lambda route: route.fulfill( status200, body{name: mock-user} )) # 模拟慢速网络 page.route(**/*, lambda route: route.continue_())4.3 文件上传与下载处理文件操作也很简单# 单文件上传 page.locator(#file-input).set_input_files(test.txt) # 多文件上传 page.locator(#file-input).set_input_files([file1.txt, file2.txt]) # 处理文件下载 with page.expect_download() as download_info: page.locator(#download-btn).click() download download_info.value print(f下载文件路径: {download.path()})5. 测试最佳实践5.1 使用Pytest集成Playwright与Pytest配合使用效果很好import pytest from playwright.sync_api import Page pytest.fixture(scopemodule) def browser_page(): with sync_playwright() as p: browser p.chromium.launch() yield browser.new_page() browser.close() def test_baidu_search(browser_page: Page): browser_page.goto(https://www.baidu.com) browser_page.locator(#kw).fill(Playwright) browser_page.locator(#su).click() assert Playwright in browser_page.title()5.2 页面对象模式对于大型项目建议使用页面对象模式class BaiduPage: def __init__(self, page: Page): self.page page self.search_input page.locator(#kw) self.search_button page.locator(#su) def navigate(self): self.page.goto(https://www.baidu.com) def search(self, keyword): self.search_input.fill(keyword) self.search_button.click() def test_search(): with sync_playwright() as p: browser p.chromium.launch() page browser.new_page() baidu BaiduPage(page) baidu.navigate() baidu.search(Playwright) assert Playwright in page.title()5.3 CI/CD集成在CI环境中我通常这样配置# .github/workflows/test.yml name: Playwright Tests on: [push] jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkoutv2 - uses: actions/setup-pythonv2 - run: pip install playwright pytest - run: playwright install - run: pytest tests/6. 常见问题与解决方案在实际项目中踩过不少坑这里分享几个常见问题的解决方法元素定位失败确保使用了正确的等待策略可以结合page.wait_for_selector()使用。我遇到过动态ID的问题最终通过XPath的文本定位解决了。iframe处理记住一定要先切换到iframe上下文再操作元素。有次测试QQ邮箱登录就因为iframe嵌套层级问题卡了好久。异步操作对于大量AJAX请求的页面建议使用page.wait_for_function()确保数据加载完成。曾经有个电商项目因为商品列表是懒加载的需要滚动到底部触发加载这时page.evaluate()执行JS滚动就派上用场了。跨域问题Playwright默认每个测试用例使用独立的浏览器上下文这本身就避免了大部分cookie污染问题。如果确实需要共享状态可以通过browser.new_context()的参数来配置。7. 性能优化技巧经过多个项目实践我总结出几个提升Playwright测试效率的方法复用浏览器实例使用browser.new_context()创建多个隔离的上下文比反复启动浏览器快得多。并行执行Pytest支持测试用例并行执行配合Playwright的独立上下文可以大幅缩短测试总时长。选择性安装在CI环境中只安装需要的浏览器比如playwright install chromium。合理使用headless模式在CI环境中使用headless模式本地调试时可以关闭。网络模拟使用page.route()拦截不必要的资源请求如图片、CSS等能显著提升测试速度。视频录制虽然会占用更多资源但在调试复杂场景时context.tracing录制操作过程非常有用。# 启用追踪记录 context browser.new_context() context.tracing.start(screenshotsTrue, snapshotsTrue) # 测试操作... context.tracing.stop(pathtrace.zip)8. 与其他工具的对比在选择测试框架时我们通常会考虑几个关键因素易用性、功能完整性、执行效率和社区支持。与Selenium相比Playwright在以下几个方面表现更出色执行速度Playwright的通信协议更高效特别是在复杂页面上测试执行速度明显快于Selenium。可靠性内置的自动等待机制减少了元素未找到这类错误测试稳定性大幅提升。功能丰富度网络拦截、iframe处理、移动设备模拟等高级功能开箱即用不需要额外插件。多语言支持虽然我们主要用Python但Playwright也支持Java、.NET和Node.js适合多技术栈团队。调试体验Playwright Inspector和Trace Viewer等工具让调试变得更加直观。不过Selenium也有其优势比如更长的历史、更庞大的用户群和更丰富的第三方集成。如果你的项目已经有一套成熟的Selenium测试体系迁移到Playwright可能需要权衡投入产出比。9. 移动端测试Playwright不仅支持桌面浏览器还能模拟移动设备测试from playwright.sync_api import sync_playwright def test_mobile(): with sync_playwright() as p: # 模拟iPhone 12 iphone p.devices[iPhone 12] browser p.chromium.launch() context browser.new_context(**iphone) page context.new_page() page.goto(https://m.baidu.com) page.screenshot(pathmobile.png) context.close()内置支持的设备列表包括iPhone、iPad、Galaxy等主流机型也可以自定义设备参数custom_device { name: Custom Device, userAgent: Mozilla/5.0..., viewport: {width: 375, height: 667}, deviceScaleFactor: 2, isMobile: True, hasTouch: True }这个功能在测试响应式设计时特别有用不需要准备真实的移动设备就能验证各种屏幕尺寸下的显示效果。10. 持续学习资源要精通Playwright我推荐以下学习路径官方文档Playwright的文档非常完善特别是Python API部分几乎涵盖了所有使用场景。官方示例库GitHub上的microsoft/playwright-python仓库提供了大量示例代码。社区插件比如pytest-playwright、allure-playwright等可以增强测试能力。在线课程Udemy和Pluralsight上有专门的Playwright课程适合视觉学习者。开源项目研究一些使用Playwright的开源项目能学到很多实战技巧。问题排查遇到问题时先在Playwright的GitHub issues中搜索很多常见问题已经有解决方案。我在学习过程中养成了一个习惯每学到一个新功能就立即在项目中找一个实际应用场景。比如学会网络拦截后马上用它来模拟后端API返回错误的情况验证前端错误处理逻辑。这种学以致用的方法效果非常好。