1. 项目概述为什么是Playwright如果你是一名测试工程师或者是一名需要频繁与Web界面打交道的开发者那么“自动化测试”这个词对你来说一定不陌生。从早期的Selenium到后来的Cypress、Puppeteer自动化测试工具层出不穷但痛点也一直存在浏览器兼容性差、执行速度慢、元素定位不稳定、对现代Web特性的支持不足……这些问题常常让自动化测试的落地和维护变得困难重重。就在这样的背景下微软在2020年推出了Playwright。我第一次接触它时是被其官方宣传的“跨浏览器、跨平台、跨语言”特性所吸引。但真正让我决定投入精力去学习和使用的是在实际项目中用它替换掉原有Selenium框架后测试用例的执行时间从平均45分钟缩短到了15分钟并且稳定性大幅提升。这不是简单的工具替换而是一次测试效率和体验的全面升级。Playwright到底是什么简单说它是一个开源的Node.js库同时提供Python、Java、.NET绑定用于自动化Chromium、Firefox和WebKit浏览器。但它的“野心”远不止于此。它通过一个统一的API让你可以用一套代码在几乎所有现代浏览器上运行测试并且原生支持无头模式、移动端模拟、网络拦截、文件上传下载等现代Web应用测试所需的一切能力。更重要的是它的设计哲学是“为现代Web而生”这意味着它对单页应用SPA、Shadow DOM、Service Workers等新特性的支持是原生且一流的。这篇文章我将从一个一线测试开发者的角度带你深入探索Playwright这个“新世界”。我不会只停留在简单的安装和“Hello World”示例而是会拆解其核心架构、分享实战中的最佳实践、剖析那些官方文档里不会写的“坑”并展示如何将其融入真实的CI/CD流水线。无论你是刚接触自动化测试的新手还是正在为现有测试框架的维护成本而头疼的资深工程师相信都能在这里找到有价值的参考。2. 核心架构与设计哲学它凭什么比Selenium快在深入代码之前理解Playwright的底层设计至关重要。这能帮你明白为什么它在某些场景下表现优异以及如何避开其设计上的潜在陷阱。2.1 进程外驱动与WebSocket通信这是Playwright与Selenium最根本的区别也是其性能优势的核心来源。Selenium WebDriver采用的是基于HTTP的JSON Wire Protocol。你的测试脚本客户端通过HTTP请求向浏览器驱动程序如ChromeDriver发送命令如“点击”驱动程序再通过浏览器提供的调试协议如Chrome DevTools Protocol来控制浏览器。这个过程中存在多次网络序列化/反序列化开销并且是典型的“请求-响应”模式浏览器端的事件如元素加载、网络请求完成无法主动、实时地通知给客户端。Playwright则采用了完全不同的方式。它直接与浏览器的调试协议CDP for Chromium, Firefox DevTools Protocol for Firefox等通信并且是进程外驱动。当你启动Playwright时它会启动一个独立的浏览器进程并通过WebSocket与之建立双向、全双工的通信通道。这个设计带来了几个关键优势更低的延迟和更高的吞吐量WebSocket是长连接避免了HTTP的握手开销命令传输更快。事件驱动浏览器可以主动向测试脚本推送事件如page.on(‘request’)使得等待和断言变得更加高效和自然。你不需要轮询而是监听事件。更稳定的上下文管理Playwright直接管理浏览器上下文BrowserContext每个上下文都相互隔离包括cookies、localStorage这比Selenium中通过不同driver实例来实现隔离要轻量和可靠得多。用一个生活化的比喻Selenium像打电话每次都要拨号、等待接通、说完挂断而Playwright像开了一个永远在线的对讲机频道随时可以通话对方也能随时插话。2.2 自动等待告别“sleep”和“显式等待”的救星元素定位不稳定是UI自动化测试的“头号杀手”。传统方案中我们不得不大量使用time.sleep或WebDriverWait来等待元素出现、可点击或可见。Playwright将自动等待内置于几乎所有的操作中。当你执行page.click(‘button#submit’)时Playwright会依次执行以下检查直到条件满足才执行点击否则超时失败等待元素**附加attached**到DOM。等待元素可见visible。等待元素可交互enabled。等待元素稳定stable例如动画结束。滚动元素到视图中。等待元素接收指针事件如不被其他元素遮挡。这意味着在绝大多数情况下你不需要再写显式等待。你的代码会变得异常简洁和健壮。当然自动等待有超时时间默认30秒你可以通过timeout选项全局或局部调整。实操心得虽然自动等待很强大但对于某些动态加载极其复杂或依赖特定非DOM状态如某个全局JS变量变化的场景我仍然会配合使用page.wait_for_function()或page.wait_for_event()作为补充形成“自动等待为主精准等待为辅”的策略。2.3 浏览器上下文BrowserContext与多页面模型这是Playwright中一个非常核心且强大的抽象概念理解它才能用好Playwright。Browser对应一个实际的浏览器进程如Chrome。BrowserContext一个完全隔离的会话环境类似于一个隐身模式窗口。它拥有独立的cookie、缓存、本地存储和证书。你可以从一个Browser实例创建多个Context。Page一个标签页。一个Context中可以包含多个Page。这种层级关系Browser - Context - Page带来了巨大的灵活性并行测试可以为每个测试用例创建一个独立的Context实现完全的隔离避免用例间相互污染。这比创建多个Browser实例要轻量得多。模拟多用户场景轻松创建多个Context来模拟不同用户同时登录和操作。权限和地理定位模拟可以在创建Context时一次性设置好所有权限如摄像头、地理位置这些设置会应用到该Context下的所有Page。# 示例创建两个隔离的上下文来模拟两个用户 import asyncio from playwright.async_api import async_playwright async def main(): async with async_playwright() as p: browser await p.chromium.launch(headlessFalse) # 用户A的上下文 context_a await browser.new_context() page_a await context_a.new_page() await page_a.goto(https://example.com/login) # ... 用户A登录操作 # 用户A的cookies完全独立 # 用户B的上下文 context_b await browser.new_context() page_b await context_b.new_page() await page_b.goto(https://example.com/login) # ... 用户B登录操作与用户A互不干扰 await browser.close() asyncio.run(main())3. 从零到一搭建你的第一个Playwright测试框架理论说得再多不如动手实践。让我们从一个干净的Python环境开始搭建一个具备基本功能的Playwright测试框架。3.1 环境准备与安装首先确保你安装了Python建议3.7。然后通过pip安装Playwright。# 安装playwright库 pip install playwright # 安装Playwright所需的浏览器驱动Chromium, Firefox, WebKit playwright installplaywright install这一步会下载所有支持的浏览器Chromium、Firefox、WebKit到你的用户目录下例如Windows在%USERPROFILE%\AppData\Local\ms-playwright。这是Playwright的一大优点它自带经过兼容性测试的浏览器版本保证了环境的一致性避免了“在我机器上好好的”这类问题。注意事项如果网络环境导致下载缓慢或失败可以尝试设置环境变量来使用国内镜像加速下载仅对Chromium有效。但对于Firefox和WebKit可能仍需直接访问外网。这是目前使用Playwright的一个小门槛。# Windows (PowerShell) $env:PLAYWRIGHT_DOWNLOAD_HOST https://npmmirror.com/mirrors/playwright/ playwright install chromium # Linux/macOS PLAYWRIGHT_DOWNLOAD_HOSThttps://npmmirror.com/mirrors/playwright/ playwright install chromium3.2 编写第一个测试脚本同步 vs. 异步Playwright支持同步和异步两种API。对于简单的线性脚本同步API更直观。但对于需要并发操作或集成到异步框架如FastAPI中异步API性能更好。同步API示例推荐初学者from playwright.sync_api import sync_playwright def test_baidu_search(): 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.fill(#kw, Playwright自动化测试) # 点击“百度一下”按钮 page.click(#su) # 等待搜索结果页面加载自动等待机制已生效 page.wait_for_load_state(networkidle) # 等待网络基本空闲 # 断言搜索结果中是否包含特定文本 assert Playwright in page.inner_text(.content_left) # 截图保存 page.screenshot(pathsearch_results.png) # 关闭浏览器 browser.close() if __name__ __main__: test_baidu_search()异步API示例更高性能import asyncio from playwright.async_api import async_playwright async def test_baidu_search_async(): async with async_playwright() as p: browser await p.chromium.launch(headlessFalse) page await browser.new_page() await page.goto(https://www.baidu.com) print(f页面标题: {await page.title()}) await page.fill(#kw, Playwright自动化测试) await page.click(#su) await page.wait_for_load_state(networkidle) content await page.inner_text(.content_left) assert Playwright in content await page.screenshot(pathsearch_results_async.png) await browser.close() # 运行异步函数 asyncio.run(test_baidu_search_async())如何选择新手或简单脚本用同步API逻辑直白易于调试。高性能需求或已有异步生态用异步API。例如你需要同时打开10个页面执行任务异步可以大幅缩短总执行时间。3.3 元素定位告别脆弱的XPath稳定的元素定位是自动化测试的基石。Playwright提供了丰富、灵活且稳定的定位器Locators。1. 最佳实践使用get_by_*系列方法这是Playwright最推荐的方式它优先考虑可访问性和语义通常比CSS或XPath更稳定。# 通过角色Role和名称Name定位这是最稳定的方式之一 page.get_by_role(button, name登录).click() # 通过文本内容定位 page.get_by_text(提交订单).click() page.get_by_text(提交订单, exactTrue).click() # 精确匹配 # 通过Label文本定位关联的输入框 page.get_by_label(用户名).fill(myuser) # 通过Placeholder定位 page.get_by_placeholder(请输入邮箱).fill(testexample.com) # 通过Title属性定位 page.get_by_title(提示信息).hover()2. CSS选择器与XPath当get_by_*无法满足时可以回退到CSS或XPath。Playwright对CSS选择器的支持非常完善。# CSS 选择器 page.locator(input#username).fill(admin) # ID page.locator(button.submit-btn).click() # Class page.locator(div.content ul.list li:first-child).click() # 复杂CSS # XPath (尽量避免除非别无他法) page.locator(//button[idsubmit]).click()3. 组合定位与过滤器Playwright的定位器可以链式调用和过滤非常强大。# 先通过CSS定位到一个列表再过滤出包含特定文本的项 row page.locator(table tr).filter(has_text特定产品).get_by_role(button, name删除) row.click() # 使用 进行内部定位类似于CSS的嵌套 page.locator(.modal .confirm-btn).click() # 在.modal内部找.confirm-btn避坑技巧尽量避免使用依赖于元素位置如:nth-child(3)或复杂DOM结构的定位器因为它们在前端样式调整时极易失效。优先使用具有业务语义的属性如># 打开一个浏览器窗口并开始录制你的操作生成Python代码 playwright codegen https://www.baidu.com --target python -o recorded_script.py执行上述命令后会弹出一个浏览器和一个Inspector窗口。你在浏览器中的所有操作点击、输入、导航都会被实时转换成代码显示在Inspector中并最终保存到recorded_script.py。这是一个绝佳的学习工具你可以通过它来观察Playwright是如何将你的操作转化为API调用的。但请注意录制的代码通常不是最优的它可能包含不必要的等待或过于具体的定位器。不要依赖录制来生成生产环境的测试代码而应该将其作为起点然后根据前面讲到的最佳实践进行重构和优化。4. 高级特性实战应对复杂Web应用场景掌握了基础操作后我们来看看Playwright如何解决那些让传统自动化工具头疼的复杂场景。4.1 处理弹窗、新窗口与iframe弹窗Dialog Playwright可以监听并处理alert,confirm,prompt等原生弹窗。# 在触发弹窗的操作之前先监听dialog事件 page.once(dialog, lambda dialog: dialog.accept()) # 接受确定 # 或 dialog.dismiss() 取消 dialog.accept(“输入文本”) 用于prompt page.get_by_text(删除).click() # 点击后会触发confirm弹窗 # 监听器会自动处理弹窗新窗口/标签页Popup 当点击一个链接导致新窗口打开时Playwright可以轻松捕获。# 在点击之前监听popup事件 with page.expect_popup() as popup_info: page.get_by_text(在新窗口打开).click() # 这个点击会打开新窗口 new_page popup_info.value # 获取新页面的Page对象 await new_page.wait_for_load_state() print(await new_page.title())iframe 处理iframe不再是难题。你可以像对待普通页面一样获取iframe的Frame对象。# 通过iframe的name属性或URL定位 frame page.frame(namelogin-iframe) # 或者通过选择器定位iframe元素再获取其content frame frame_element page.locator(iframe[title登录框]) frame frame_element.content_frame() # 然后就可以在frame内部进行操作了 await frame.fill(#username, user) await frame.click(#submit)4.2 网络请求拦截与模拟Mocking这是Playwright的王牌功能之一可以极大提升测试速度和稳定性。拦截请求你可以监听所有请求并修改或阻止它们。模拟响应Mock直接返回预设的响应数据绕过不稳定的后端或第三方服务。# 拦截所有图片请求并阻止加载加速页面渲染 await page.route(**/*.{png,jpg,jpeg}, lambda route: route.abort()) # 拦截特定API请求并返回模拟数据 async def handle_route(route): # 获取原始请求 request route.request if /api/user/profile in request.url: # 构造一个模拟的JSON响应 await route.fulfill( status200, content_typeapplication/json, bodyjson.dumps({name: Mock User, age: 30}) ) else: # 其他请求继续正常进行 await route.continue_() # 注册路由处理器 await page.route(**/api/**, handle_route) # 然后导航页面对 /api/user/profile 的请求将收到我们的模拟数据 await page.goto(https://example.com)这个功能在以下场景非常有用测试错误场景模拟API返回500错误测试前端容错。加速测试屏蔽不必要的资源如图片、样式表、分析脚本。准备测试数据在测试开始前通过Mock API确保数据库处于特定状态。4.3 文件上传与下载文件上传Playwright让文件上传变得极其简单无需模拟复杂的input type“file”点击操作。# 定位文件输入元素直接设置文件路径 file_input page.locator(input[typefile]) await file_input.set_input_files([ path/to/file1.pdf, path/to/file2.jpg ]) # 如果要清除已选择的文件 await file_input.set_input_files([])文件下载可以监听下载事件并获取下载的文件内容或保存路径。# 在触发下载的操作前启动下载监听 async with page.expect_download() as download_info: page.get_by_text(导出报告).click() # 点击触发下载 download await download_info.value # 获取下载建议的文件名 suggested_filename download.suggested_filename # 将文件保存到指定路径 await download.save_as(f/reports/{suggested_filename}) # 或者获取文件内容对于小文件 # file_content await download.read()4.4 移动端模拟与设备仿真Playwright内置了主流移动设备如iPhone, Pixel的配置参数可以轻松模拟移动端测试。from playwright.sync_api import sync_playwright def test_mobile_view(): with sync_playwright() as p: # 使用iPhone 13的设备描述符 iphone_13 p.devices[iPhone 13] browser p.chromium.launch(headlessFalse) # 创建上下文时传入设备参数 context browser.new_context(**iphone_13) page context.new_page() page.goto(https://m.example.com) # 此时页面视图、User-Agent、触摸事件等都模拟了iPhone 13 page.screenshot(pathiphone-view.png) browser.close()你还可以自定义设备参数如视口大小、用户代理、是否支持触摸等。5. 集成与工程化让Playwright融入你的工作流单个测试脚本跑起来只是第一步。要让Playwright真正产生价值需要将其工程化集成到开发流程中。5.1 与Pytest测试框架深度集成Pytest是Python生态中最流行的测试框架。Playwright官方提供了pytest-playwright插件让集成变得无缝。安装与配置pip install pytest pytest-playwright编写Pytest测试用例创建一个test_example.py文件import re from playwright.sync_api import Page, expect def test_has_title(page: Page): 测试页面标题是否正确 page.goto(https://playwright.dev/) # 使用Playwright内置的expect断言可读性更好 expect(page).to_have_title(re.compile(Playwright)) def test_get_started_link(page: Page): 测试导航链接 page.goto(https://playwright.dev/) # 定位“Get started”链接并点击 get_started page.get_by_role(link, nameGet started) get_started.click() # 断言跳转后的URL expect(page).to_have_url(re.compile(.*/docs/intro))运行测试# 运行所有测试 pytest # 运行特定文件并显示详细日志 pytest test_example.py -v # 在无头模式下运行并生成HTML报告 pytest --browser chromium --headless --htmlreport.htmlpytest-playwright插件会自动管理浏览器的启动和关闭并为每个测试用例提供干净的pagefixture。它还提供了诸如browser,context,browser_name等有用的fixture。5.2 配置管理环境变量与配置文件硬编码的URL和凭证是测试脚本的大忌。使用配置文件或环境变量来管理它们。# conftest.py (Pytest的配置文件) import os import pytest from playwright.sync_api import Browser, BrowserContext pytest.fixture(scopesession) def base_url(pytestconfig): 从命令行参数或环境变量获取基础URL return pytestconfig.getoption(--base-url) or os.getenv(BASE_URL, https://staging.example.com) pytest.fixture def authenticated_context(browser: Browser, base_url: str) - BrowserContext: 创建一个已登录的浏览器上下文 context browser.new_context() page context.new_page() page.goto(f{base_url}/login) page.fill(#username, os.getenv(TEST_USER)) page.fill(#password, os.getenv(TEST_PASS)) page.click(#login-btn) # 等待登录成功例如跳转到首页 page.wait_for_url(f{base_url}/dashboard) # 将登录状态cookies保存下来供后续测试复用 # context.storage_state(pathstate.json) yield context context.close() # 在测试用例中使用 def test_dashboard(authenticated_context: BrowserContext): page authenticated_context.new_page() page.goto(/dashboard) expect(page.locator(h1)).to_have_text(我的仪表盘)通过命令行传递参数运行BASE_URLhttps://prod.example.com TEST_USERadmin TEST_PASSsecret pytest # 或 pytest --base-urlhttps://prod.example.com5.3 持续集成CI与无头模式运行在CI服务器如GitHub Actions, GitLab CI, Jenkins上运行Playwright测试是标准操作。关键点无头模式HeadlessCI环境中必须使用headlessTrue。依赖安装需要安装Playwright Python包和浏览器。系统依赖Linux服务器可能需要安装一些额外的库如libwoff2。一个典型的GitHub Actions工作流配置.github/workflows/playwright.ymlname: Playwright Tests on: [push, pull_request] jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkoutv3 - name: Set up Python uses: actions/setup-pythonv4 with: python-version: 3.10 - name: Install dependencies run: | pip install -r requirements.txt pip install playwright playwright install --with-deps chromium # 只安装Chromium及其系统依赖 - name: Run tests run: | pytest --browser chromium --headless env: BASE_URL: ${{ secrets.BASE_URL }} TEST_USER: ${{ secrets.TEST_USER }} TEST_PASS: ${{ secrets.TEST_PASS }} - name: Upload test artifacts if: always() # 即使测试失败也上传 uses: actions/upload-artifactv3 with: name: playwright-report path: playwright-report/ # 假设使用pytest-html等插件生成报告 retention-days: 75.4 测试报告与追踪清晰的测试报告对于问题定位至关重要。除了Pytest自带的报告可以集成更强大的工具。1. Allure报告 Allure能生成非常美观且信息丰富的交互式报告。pip install allure-pytest pytest --browser chromium --headless --alluredir./allure-results # 生成报告 allure serve ./allure-results2. Playwright Trace Viewer 这是Playwright独有的杀手锏。它可以记录测试执行过程中的每一个动作、网络请求、控制台日志并生成一个可视化的时间线。# 在测试开始时启动追踪 context.tracing.start(screenshotsTrue, snapshotsTrue, sourcesTrue) # ... 执行测试操作 ... # 在测试结束时停止并保存追踪文件 context.tracing.stop(pathtrace.zip)当测试失败时你可以通过playwright show-trace trace.zip命令打开一个图形化界面像调试器一样一步步回放测试过程精确查看哪一步出了问题、当时的页面状态是什么。这对于调试偶发性的UI测试失败极其有用。6. 常见问题排查与性能优化实战即使工具再强大在实际项目中也会遇到各种问题。下面是我在多个项目中总结出的常见“坑”和解决方案。6.1 元素定位失败动态内容与等待策略问题page.click(‘button’)报错TimeoutError: Timeout 30000ms exceeded。排查思路确认选择器是否正确使用Playwright Inspector (playwright open或playwright codegen) 实时验证你的选择器是否能唯一定位到元素。检查元素状态元素可能被隐藏display: none、不可交互disabled或被其他元素覆盖。Playwright的自动等待会检查这些但如果你的超时时间设置太短可能等不到元素变为可用状态。可以尝试增加超时page.click(‘button’, timeout60000)。处理动态内容对于SPA应用内容可能是异步加载的。确保在操作前页面已经处于稳定状态。除了page.wait_for_load_state(‘networkidle’)还可以使用更精确的等待# 等待特定元素出现 await page.wait_for_selector(‘.loading-spinner’, state‘hidden’) # 等待加载动画消失 await page.wait_for_selector(‘data-testidproduct-list’, state‘visible’) # 等待特定文本出现 await page.wait_for_selector(‘text“加载完成”’) # 等待一个函数返回true await page.wait_for_function(‘window.appState “ready”’)iframe或Shadow DOM确保你的操作目标在正确的Frame或Shadow Root内。6.2 测试执行速度慢优化策略复用浏览器上下文避免每个测试用例都启动和关闭浏览器。使用Pytest的session或module级别的fixture来共享一个Browser实例但为每个测试创建独立的Context。pytest.fixture(scopesession) def browser_instance(): with sync_playwright() as p: browser p.chromium.launch(headlessTrue) yield browser browser.close() pytest.fixture(scopefunction) def context(browser_instance): context browser_instance.new_context() yield context context.close()并行执行Pytest可以通过pytest-xdist插件实现并行测试。结合独立的BrowserContext可以安全地并行运行。pip install pytest-xdist pytest -n auto # 自动检测CPU核心数并行运行拦截不必要的资源如前面所述使用page.route拦截并中止对图片、字体、样式表非关键路径或第三方分析脚本的请求。使用无头模式在CI和本地调试通过后始终使用headlessTrue运行这比显示浏览器界面快得多。6.3 在CI环境中安装浏览器失败或速度慢问题playwright install在CI服务器上卡住或报错。解决方案使用官方CI容器Playwright为GitHub Actions等CI提供了预装好所有依赖的Docker镜像这是最省事的方式。jobs: test: container: image: mcr.microsoft.com/playwright/python:v1.40.0-jammy # 使用特定版本 steps: - run: | pip install -r requirements.txt pytest只安装需要的浏览器如果你只测试Chromium就不要安装全部浏览器。playwright install chromium # 或指定版本 playwright install chromiumstable-1090缓存浏览器二进制文件在CI配置中将Playwright的浏览器安装目录如~/.cache/ms-playwright设置为缓存避免每次流水线都重新下载。6.4 处理非标准认证如公司单点登录SSO场景公司内部应用需要先通过一个统一的登录页面认证。方案不要在UI测试中反复走完整的SSO流程。有两种更优解复用认证状态在测试套件开始前用UI操作登录一次然后保存浏览器上下文的存储状态cookies, localStorage。# 登录并保存状态 context browser.new_context() page context.new_page() # ... 完成SSO登录流程 ... context.storage_state(pathauth_state.json) context.close() # 在后续测试中加载状态 context browser.new_context(storage_stateauth_state.json) page context.new_page() page.goto(https://internal-app.example.com) # 此时已登录后端API获取Token如果应用支持通过调用后端登录API直接获取认证Token如JWT然后通过page.add_init_script将其注入到localStorage或设置到请求头中。token get_auth_token_via_api(username, password) context browser.new_context() await context.add_init_script(f window.localStorage.setItem(auth_token, {token}); ) page context.new_page()6.5 与Visual Studio Code深度集成VSCode有优秀的Playwright插件可以极大提升开发体验。安装插件搜索并安装“Playwright Test for VSCode”。代码智能提示获得完整的API智能补全和文档提示。图形化测试运行器在侧边栏可以看到所有的测试用例并可以点击单独运行或调试某个测试。时间旅行调试在调试模式下运行测试时插件会自动记录Trace。测试失败后可以直接在VSCode里打开Trace Viewer进行可视化调试无需命令行。7. 超越WebPlaywright的未来与生态展望Playwright的野心并不止于Web浏览器测试。其核心的“自动化驱动”能力正在向更广泛的领域扩展。1. Playwright for .NET, Java如果你团队的主力语言是C#或Java现在也可以享受到Playwright带来的便利API设计基本与Python/Node.js版本一致。2. Playwright Test Runner这是微软围绕Playwright构建的一个专门的测试运行器playwright/test它比单纯用Pytest集成提供了更多开箱即用的功能如并行化、HTML报告、Trace、视频录制、全局配置等。虽然主要面向Node.js但其设计理念值得Python生态借鉴。3. 移动端原生应用测试实验性Playwright团队正在探索通过其协议支持Android和iOS原生应用的自动化。虽然目前还不成熟但这预示着一个“大一统”的端到端自动化测试框架的可能性。4. 与AI结合社区已经出现了一些探索例如利用Playwright自动浏览网页收集数据结合LLM大语言模型进行内容分析和摘要。其稳定可靠的浏览器控制能力使其成为AI Agent与真实Web世界交互的“手和眼”。在我个人的技术选型中对于新的Web项目Playwright已经成为了UI自动化测试的首选。它的现代化设计、出色的性能、丰富的功能以及活跃的社区都让它站在了当前自动化测试工具链的顶端。从Selenium迁移过来可能需要一些学习成本但长期来看在测试稳定性、开发效率和维护成本上带来的收益是巨大的。
Playwright自动化测试实战：从架构原理到CI/CD集成
发布时间：2026/7/3 1:48:13
1. 项目概述为什么是Playwright如果你是一名测试工程师或者是一名需要频繁与Web界面打交道的开发者那么“自动化测试”这个词对你来说一定不陌生。从早期的Selenium到后来的Cypress、Puppeteer自动化测试工具层出不穷但痛点也一直存在浏览器兼容性差、执行速度慢、元素定位不稳定、对现代Web特性的支持不足……这些问题常常让自动化测试的落地和维护变得困难重重。就在这样的背景下微软在2020年推出了Playwright。我第一次接触它时是被其官方宣传的“跨浏览器、跨平台、跨语言”特性所吸引。但真正让我决定投入精力去学习和使用的是在实际项目中用它替换掉原有Selenium框架后测试用例的执行时间从平均45分钟缩短到了15分钟并且稳定性大幅提升。这不是简单的工具替换而是一次测试效率和体验的全面升级。Playwright到底是什么简单说它是一个开源的Node.js库同时提供Python、Java、.NET绑定用于自动化Chromium、Firefox和WebKit浏览器。但它的“野心”远不止于此。它通过一个统一的API让你可以用一套代码在几乎所有现代浏览器上运行测试并且原生支持无头模式、移动端模拟、网络拦截、文件上传下载等现代Web应用测试所需的一切能力。更重要的是它的设计哲学是“为现代Web而生”这意味着它对单页应用SPA、Shadow DOM、Service Workers等新特性的支持是原生且一流的。这篇文章我将从一个一线测试开发者的角度带你深入探索Playwright这个“新世界”。我不会只停留在简单的安装和“Hello World”示例而是会拆解其核心架构、分享实战中的最佳实践、剖析那些官方文档里不会写的“坑”并展示如何将其融入真实的CI/CD流水线。无论你是刚接触自动化测试的新手还是正在为现有测试框架的维护成本而头疼的资深工程师相信都能在这里找到有价值的参考。2. 核心架构与设计哲学它凭什么比Selenium快在深入代码之前理解Playwright的底层设计至关重要。这能帮你明白为什么它在某些场景下表现优异以及如何避开其设计上的潜在陷阱。2.1 进程外驱动与WebSocket通信这是Playwright与Selenium最根本的区别也是其性能优势的核心来源。Selenium WebDriver采用的是基于HTTP的JSON Wire Protocol。你的测试脚本客户端通过HTTP请求向浏览器驱动程序如ChromeDriver发送命令如“点击”驱动程序再通过浏览器提供的调试协议如Chrome DevTools Protocol来控制浏览器。这个过程中存在多次网络序列化/反序列化开销并且是典型的“请求-响应”模式浏览器端的事件如元素加载、网络请求完成无法主动、实时地通知给客户端。Playwright则采用了完全不同的方式。它直接与浏览器的调试协议CDP for Chromium, Firefox DevTools Protocol for Firefox等通信并且是进程外驱动。当你启动Playwright时它会启动一个独立的浏览器进程并通过WebSocket与之建立双向、全双工的通信通道。这个设计带来了几个关键优势更低的延迟和更高的吞吐量WebSocket是长连接避免了HTTP的握手开销命令传输更快。事件驱动浏览器可以主动向测试脚本推送事件如page.on(‘request’)使得等待和断言变得更加高效和自然。你不需要轮询而是监听事件。更稳定的上下文管理Playwright直接管理浏览器上下文BrowserContext每个上下文都相互隔离包括cookies、localStorage这比Selenium中通过不同driver实例来实现隔离要轻量和可靠得多。用一个生活化的比喻Selenium像打电话每次都要拨号、等待接通、说完挂断而Playwright像开了一个永远在线的对讲机频道随时可以通话对方也能随时插话。2.2 自动等待告别“sleep”和“显式等待”的救星元素定位不稳定是UI自动化测试的“头号杀手”。传统方案中我们不得不大量使用time.sleep或WebDriverWait来等待元素出现、可点击或可见。Playwright将自动等待内置于几乎所有的操作中。当你执行page.click(‘button#submit’)时Playwright会依次执行以下检查直到条件满足才执行点击否则超时失败等待元素**附加attached**到DOM。等待元素可见visible。等待元素可交互enabled。等待元素稳定stable例如动画结束。滚动元素到视图中。等待元素接收指针事件如不被其他元素遮挡。这意味着在绝大多数情况下你不需要再写显式等待。你的代码会变得异常简洁和健壮。当然自动等待有超时时间默认30秒你可以通过timeout选项全局或局部调整。实操心得虽然自动等待很强大但对于某些动态加载极其复杂或依赖特定非DOM状态如某个全局JS变量变化的场景我仍然会配合使用page.wait_for_function()或page.wait_for_event()作为补充形成“自动等待为主精准等待为辅”的策略。2.3 浏览器上下文BrowserContext与多页面模型这是Playwright中一个非常核心且强大的抽象概念理解它才能用好Playwright。Browser对应一个实际的浏览器进程如Chrome。BrowserContext一个完全隔离的会话环境类似于一个隐身模式窗口。它拥有独立的cookie、缓存、本地存储和证书。你可以从一个Browser实例创建多个Context。Page一个标签页。一个Context中可以包含多个Page。这种层级关系Browser - Context - Page带来了巨大的灵活性并行测试可以为每个测试用例创建一个独立的Context实现完全的隔离避免用例间相互污染。这比创建多个Browser实例要轻量得多。模拟多用户场景轻松创建多个Context来模拟不同用户同时登录和操作。权限和地理定位模拟可以在创建Context时一次性设置好所有权限如摄像头、地理位置这些设置会应用到该Context下的所有Page。# 示例创建两个隔离的上下文来模拟两个用户 import asyncio from playwright.async_api import async_playwright async def main(): async with async_playwright() as p: browser await p.chromium.launch(headlessFalse) # 用户A的上下文 context_a await browser.new_context() page_a await context_a.new_page() await page_a.goto(https://example.com/login) # ... 用户A登录操作 # 用户A的cookies完全独立 # 用户B的上下文 context_b await browser.new_context() page_b await context_b.new_page() await page_b.goto(https://example.com/login) # ... 用户B登录操作与用户A互不干扰 await browser.close() asyncio.run(main())3. 从零到一搭建你的第一个Playwright测试框架理论说得再多不如动手实践。让我们从一个干净的Python环境开始搭建一个具备基本功能的Playwright测试框架。3.1 环境准备与安装首先确保你安装了Python建议3.7。然后通过pip安装Playwright。# 安装playwright库 pip install playwright # 安装Playwright所需的浏览器驱动Chromium, Firefox, WebKit playwright installplaywright install这一步会下载所有支持的浏览器Chromium、Firefox、WebKit到你的用户目录下例如Windows在%USERPROFILE%\AppData\Local\ms-playwright。这是Playwright的一大优点它自带经过兼容性测试的浏览器版本保证了环境的一致性避免了“在我机器上好好的”这类问题。注意事项如果网络环境导致下载缓慢或失败可以尝试设置环境变量来使用国内镜像加速下载仅对Chromium有效。但对于Firefox和WebKit可能仍需直接访问外网。这是目前使用Playwright的一个小门槛。# Windows (PowerShell) $env:PLAYWRIGHT_DOWNLOAD_HOST https://npmmirror.com/mirrors/playwright/ playwright install chromium # Linux/macOS PLAYWRIGHT_DOWNLOAD_HOSThttps://npmmirror.com/mirrors/playwright/ playwright install chromium3.2 编写第一个测试脚本同步 vs. 异步Playwright支持同步和异步两种API。对于简单的线性脚本同步API更直观。但对于需要并发操作或集成到异步框架如FastAPI中异步API性能更好。同步API示例推荐初学者from playwright.sync_api import sync_playwright def test_baidu_search(): 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.fill(#kw, Playwright自动化测试) # 点击“百度一下”按钮 page.click(#su) # 等待搜索结果页面加载自动等待机制已生效 page.wait_for_load_state(networkidle) # 等待网络基本空闲 # 断言搜索结果中是否包含特定文本 assert Playwright in page.inner_text(.content_left) # 截图保存 page.screenshot(pathsearch_results.png) # 关闭浏览器 browser.close() if __name__ __main__: test_baidu_search()异步API示例更高性能import asyncio from playwright.async_api import async_playwright async def test_baidu_search_async(): async with async_playwright() as p: browser await p.chromium.launch(headlessFalse) page await browser.new_page() await page.goto(https://www.baidu.com) print(f页面标题: {await page.title()}) await page.fill(#kw, Playwright自动化测试) await page.click(#su) await page.wait_for_load_state(networkidle) content await page.inner_text(.content_left) assert Playwright in content await page.screenshot(pathsearch_results_async.png) await browser.close() # 运行异步函数 asyncio.run(test_baidu_search_async())如何选择新手或简单脚本用同步API逻辑直白易于调试。高性能需求或已有异步生态用异步API。例如你需要同时打开10个页面执行任务异步可以大幅缩短总执行时间。3.3 元素定位告别脆弱的XPath稳定的元素定位是自动化测试的基石。Playwright提供了丰富、灵活且稳定的定位器Locators。1. 最佳实践使用get_by_*系列方法这是Playwright最推荐的方式它优先考虑可访问性和语义通常比CSS或XPath更稳定。# 通过角色Role和名称Name定位这是最稳定的方式之一 page.get_by_role(button, name登录).click() # 通过文本内容定位 page.get_by_text(提交订单).click() page.get_by_text(提交订单, exactTrue).click() # 精确匹配 # 通过Label文本定位关联的输入框 page.get_by_label(用户名).fill(myuser) # 通过Placeholder定位 page.get_by_placeholder(请输入邮箱).fill(testexample.com) # 通过Title属性定位 page.get_by_title(提示信息).hover()2. CSS选择器与XPath当get_by_*无法满足时可以回退到CSS或XPath。Playwright对CSS选择器的支持非常完善。# CSS 选择器 page.locator(input#username).fill(admin) # ID page.locator(button.submit-btn).click() # Class page.locator(div.content ul.list li:first-child).click() # 复杂CSS # XPath (尽量避免除非别无他法) page.locator(//button[idsubmit]).click()3. 组合定位与过滤器Playwright的定位器可以链式调用和过滤非常强大。# 先通过CSS定位到一个列表再过滤出包含特定文本的项 row page.locator(table tr).filter(has_text特定产品).get_by_role(button, name删除) row.click() # 使用 进行内部定位类似于CSS的嵌套 page.locator(.modal .confirm-btn).click() # 在.modal内部找.confirm-btn避坑技巧尽量避免使用依赖于元素位置如:nth-child(3)或复杂DOM结构的定位器因为它们在前端样式调整时极易失效。优先使用具有业务语义的属性如># 打开一个浏览器窗口并开始录制你的操作生成Python代码 playwright codegen https://www.baidu.com --target python -o recorded_script.py执行上述命令后会弹出一个浏览器和一个Inspector窗口。你在浏览器中的所有操作点击、输入、导航都会被实时转换成代码显示在Inspector中并最终保存到recorded_script.py。这是一个绝佳的学习工具你可以通过它来观察Playwright是如何将你的操作转化为API调用的。但请注意录制的代码通常不是最优的它可能包含不必要的等待或过于具体的定位器。不要依赖录制来生成生产环境的测试代码而应该将其作为起点然后根据前面讲到的最佳实践进行重构和优化。4. 高级特性实战应对复杂Web应用场景掌握了基础操作后我们来看看Playwright如何解决那些让传统自动化工具头疼的复杂场景。4.1 处理弹窗、新窗口与iframe弹窗Dialog Playwright可以监听并处理alert,confirm,prompt等原生弹窗。# 在触发弹窗的操作之前先监听dialog事件 page.once(dialog, lambda dialog: dialog.accept()) # 接受确定 # 或 dialog.dismiss() 取消 dialog.accept(“输入文本”) 用于prompt page.get_by_text(删除).click() # 点击后会触发confirm弹窗 # 监听器会自动处理弹窗新窗口/标签页Popup 当点击一个链接导致新窗口打开时Playwright可以轻松捕获。# 在点击之前监听popup事件 with page.expect_popup() as popup_info: page.get_by_text(在新窗口打开).click() # 这个点击会打开新窗口 new_page popup_info.value # 获取新页面的Page对象 await new_page.wait_for_load_state() print(await new_page.title())iframe 处理iframe不再是难题。你可以像对待普通页面一样获取iframe的Frame对象。# 通过iframe的name属性或URL定位 frame page.frame(namelogin-iframe) # 或者通过选择器定位iframe元素再获取其content frame frame_element page.locator(iframe[title登录框]) frame frame_element.content_frame() # 然后就可以在frame内部进行操作了 await frame.fill(#username, user) await frame.click(#submit)4.2 网络请求拦截与模拟Mocking这是Playwright的王牌功能之一可以极大提升测试速度和稳定性。拦截请求你可以监听所有请求并修改或阻止它们。模拟响应Mock直接返回预设的响应数据绕过不稳定的后端或第三方服务。# 拦截所有图片请求并阻止加载加速页面渲染 await page.route(**/*.{png,jpg,jpeg}, lambda route: route.abort()) # 拦截特定API请求并返回模拟数据 async def handle_route(route): # 获取原始请求 request route.request if /api/user/profile in request.url: # 构造一个模拟的JSON响应 await route.fulfill( status200, content_typeapplication/json, bodyjson.dumps({name: Mock User, age: 30}) ) else: # 其他请求继续正常进行 await route.continue_() # 注册路由处理器 await page.route(**/api/**, handle_route) # 然后导航页面对 /api/user/profile 的请求将收到我们的模拟数据 await page.goto(https://example.com)这个功能在以下场景非常有用测试错误场景模拟API返回500错误测试前端容错。加速测试屏蔽不必要的资源如图片、样式表、分析脚本。准备测试数据在测试开始前通过Mock API确保数据库处于特定状态。4.3 文件上传与下载文件上传Playwright让文件上传变得极其简单无需模拟复杂的input type“file”点击操作。# 定位文件输入元素直接设置文件路径 file_input page.locator(input[typefile]) await file_input.set_input_files([ path/to/file1.pdf, path/to/file2.jpg ]) # 如果要清除已选择的文件 await file_input.set_input_files([])文件下载可以监听下载事件并获取下载的文件内容或保存路径。# 在触发下载的操作前启动下载监听 async with page.expect_download() as download_info: page.get_by_text(导出报告).click() # 点击触发下载 download await download_info.value # 获取下载建议的文件名 suggested_filename download.suggested_filename # 将文件保存到指定路径 await download.save_as(f/reports/{suggested_filename}) # 或者获取文件内容对于小文件 # file_content await download.read()4.4 移动端模拟与设备仿真Playwright内置了主流移动设备如iPhone, Pixel的配置参数可以轻松模拟移动端测试。from playwright.sync_api import sync_playwright def test_mobile_view(): with sync_playwright() as p: # 使用iPhone 13的设备描述符 iphone_13 p.devices[iPhone 13] browser p.chromium.launch(headlessFalse) # 创建上下文时传入设备参数 context browser.new_context(**iphone_13) page context.new_page() page.goto(https://m.example.com) # 此时页面视图、User-Agent、触摸事件等都模拟了iPhone 13 page.screenshot(pathiphone-view.png) browser.close()你还可以自定义设备参数如视口大小、用户代理、是否支持触摸等。5. 集成与工程化让Playwright融入你的工作流单个测试脚本跑起来只是第一步。要让Playwright真正产生价值需要将其工程化集成到开发流程中。5.1 与Pytest测试框架深度集成Pytest是Python生态中最流行的测试框架。Playwright官方提供了pytest-playwright插件让集成变得无缝。安装与配置pip install pytest pytest-playwright编写Pytest测试用例创建一个test_example.py文件import re from playwright.sync_api import Page, expect def test_has_title(page: Page): 测试页面标题是否正确 page.goto(https://playwright.dev/) # 使用Playwright内置的expect断言可读性更好 expect(page).to_have_title(re.compile(Playwright)) def test_get_started_link(page: Page): 测试导航链接 page.goto(https://playwright.dev/) # 定位“Get started”链接并点击 get_started page.get_by_role(link, nameGet started) get_started.click() # 断言跳转后的URL expect(page).to_have_url(re.compile(.*/docs/intro))运行测试# 运行所有测试 pytest # 运行特定文件并显示详细日志 pytest test_example.py -v # 在无头模式下运行并生成HTML报告 pytest --browser chromium --headless --htmlreport.htmlpytest-playwright插件会自动管理浏览器的启动和关闭并为每个测试用例提供干净的pagefixture。它还提供了诸如browser,context,browser_name等有用的fixture。5.2 配置管理环境变量与配置文件硬编码的URL和凭证是测试脚本的大忌。使用配置文件或环境变量来管理它们。# conftest.py (Pytest的配置文件) import os import pytest from playwright.sync_api import Browser, BrowserContext pytest.fixture(scopesession) def base_url(pytestconfig): 从命令行参数或环境变量获取基础URL return pytestconfig.getoption(--base-url) or os.getenv(BASE_URL, https://staging.example.com) pytest.fixture def authenticated_context(browser: Browser, base_url: str) - BrowserContext: 创建一个已登录的浏览器上下文 context browser.new_context() page context.new_page() page.goto(f{base_url}/login) page.fill(#username, os.getenv(TEST_USER)) page.fill(#password, os.getenv(TEST_PASS)) page.click(#login-btn) # 等待登录成功例如跳转到首页 page.wait_for_url(f{base_url}/dashboard) # 将登录状态cookies保存下来供后续测试复用 # context.storage_state(pathstate.json) yield context context.close() # 在测试用例中使用 def test_dashboard(authenticated_context: BrowserContext): page authenticated_context.new_page() page.goto(/dashboard) expect(page.locator(h1)).to_have_text(我的仪表盘)通过命令行传递参数运行BASE_URLhttps://prod.example.com TEST_USERadmin TEST_PASSsecret pytest # 或 pytest --base-urlhttps://prod.example.com5.3 持续集成CI与无头模式运行在CI服务器如GitHub Actions, GitLab CI, Jenkins上运行Playwright测试是标准操作。关键点无头模式HeadlessCI环境中必须使用headlessTrue。依赖安装需要安装Playwright Python包和浏览器。系统依赖Linux服务器可能需要安装一些额外的库如libwoff2。一个典型的GitHub Actions工作流配置.github/workflows/playwright.ymlname: Playwright Tests on: [push, pull_request] jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkoutv3 - name: Set up Python uses: actions/setup-pythonv4 with: python-version: 3.10 - name: Install dependencies run: | pip install -r requirements.txt pip install playwright playwright install --with-deps chromium # 只安装Chromium及其系统依赖 - name: Run tests run: | pytest --browser chromium --headless env: BASE_URL: ${{ secrets.BASE_URL }} TEST_USER: ${{ secrets.TEST_USER }} TEST_PASS: ${{ secrets.TEST_PASS }} - name: Upload test artifacts if: always() # 即使测试失败也上传 uses: actions/upload-artifactv3 with: name: playwright-report path: playwright-report/ # 假设使用pytest-html等插件生成报告 retention-days: 75.4 测试报告与追踪清晰的测试报告对于问题定位至关重要。除了Pytest自带的报告可以集成更强大的工具。1. Allure报告 Allure能生成非常美观且信息丰富的交互式报告。pip install allure-pytest pytest --browser chromium --headless --alluredir./allure-results # 生成报告 allure serve ./allure-results2. Playwright Trace Viewer 这是Playwright独有的杀手锏。它可以记录测试执行过程中的每一个动作、网络请求、控制台日志并生成一个可视化的时间线。# 在测试开始时启动追踪 context.tracing.start(screenshotsTrue, snapshotsTrue, sourcesTrue) # ... 执行测试操作 ... # 在测试结束时停止并保存追踪文件 context.tracing.stop(pathtrace.zip)当测试失败时你可以通过playwright show-trace trace.zip命令打开一个图形化界面像调试器一样一步步回放测试过程精确查看哪一步出了问题、当时的页面状态是什么。这对于调试偶发性的UI测试失败极其有用。6. 常见问题排查与性能优化实战即使工具再强大在实际项目中也会遇到各种问题。下面是我在多个项目中总结出的常见“坑”和解决方案。6.1 元素定位失败动态内容与等待策略问题page.click(‘button’)报错TimeoutError: Timeout 30000ms exceeded。排查思路确认选择器是否正确使用Playwright Inspector (playwright open或playwright codegen) 实时验证你的选择器是否能唯一定位到元素。检查元素状态元素可能被隐藏display: none、不可交互disabled或被其他元素覆盖。Playwright的自动等待会检查这些但如果你的超时时间设置太短可能等不到元素变为可用状态。可以尝试增加超时page.click(‘button’, timeout60000)。处理动态内容对于SPA应用内容可能是异步加载的。确保在操作前页面已经处于稳定状态。除了page.wait_for_load_state(‘networkidle’)还可以使用更精确的等待# 等待特定元素出现 await page.wait_for_selector(‘.loading-spinner’, state‘hidden’) # 等待加载动画消失 await page.wait_for_selector(‘data-testidproduct-list’, state‘visible’) # 等待特定文本出现 await page.wait_for_selector(‘text“加载完成”’) # 等待一个函数返回true await page.wait_for_function(‘window.appState “ready”’)iframe或Shadow DOM确保你的操作目标在正确的Frame或Shadow Root内。6.2 测试执行速度慢优化策略复用浏览器上下文避免每个测试用例都启动和关闭浏览器。使用Pytest的session或module级别的fixture来共享一个Browser实例但为每个测试创建独立的Context。pytest.fixture(scopesession) def browser_instance(): with sync_playwright() as p: browser p.chromium.launch(headlessTrue) yield browser browser.close() pytest.fixture(scopefunction) def context(browser_instance): context browser_instance.new_context() yield context context.close()并行执行Pytest可以通过pytest-xdist插件实现并行测试。结合独立的BrowserContext可以安全地并行运行。pip install pytest-xdist pytest -n auto # 自动检测CPU核心数并行运行拦截不必要的资源如前面所述使用page.route拦截并中止对图片、字体、样式表非关键路径或第三方分析脚本的请求。使用无头模式在CI和本地调试通过后始终使用headlessTrue运行这比显示浏览器界面快得多。6.3 在CI环境中安装浏览器失败或速度慢问题playwright install在CI服务器上卡住或报错。解决方案使用官方CI容器Playwright为GitHub Actions等CI提供了预装好所有依赖的Docker镜像这是最省事的方式。jobs: test: container: image: mcr.microsoft.com/playwright/python:v1.40.0-jammy # 使用特定版本 steps: - run: | pip install -r requirements.txt pytest只安装需要的浏览器如果你只测试Chromium就不要安装全部浏览器。playwright install chromium # 或指定版本 playwright install chromiumstable-1090缓存浏览器二进制文件在CI配置中将Playwright的浏览器安装目录如~/.cache/ms-playwright设置为缓存避免每次流水线都重新下载。6.4 处理非标准认证如公司单点登录SSO场景公司内部应用需要先通过一个统一的登录页面认证。方案不要在UI测试中反复走完整的SSO流程。有两种更优解复用认证状态在测试套件开始前用UI操作登录一次然后保存浏览器上下文的存储状态cookies, localStorage。# 登录并保存状态 context browser.new_context() page context.new_page() # ... 完成SSO登录流程 ... context.storage_state(pathauth_state.json) context.close() # 在后续测试中加载状态 context browser.new_context(storage_stateauth_state.json) page context.new_page() page.goto(https://internal-app.example.com) # 此时已登录后端API获取Token如果应用支持通过调用后端登录API直接获取认证Token如JWT然后通过page.add_init_script将其注入到localStorage或设置到请求头中。token get_auth_token_via_api(username, password) context browser.new_context() await context.add_init_script(f window.localStorage.setItem(auth_token, {token}); ) page context.new_page()6.5 与Visual Studio Code深度集成VSCode有优秀的Playwright插件可以极大提升开发体验。安装插件搜索并安装“Playwright Test for VSCode”。代码智能提示获得完整的API智能补全和文档提示。图形化测试运行器在侧边栏可以看到所有的测试用例并可以点击单独运行或调试某个测试。时间旅行调试在调试模式下运行测试时插件会自动记录Trace。测试失败后可以直接在VSCode里打开Trace Viewer进行可视化调试无需命令行。7. 超越WebPlaywright的未来与生态展望Playwright的野心并不止于Web浏览器测试。其核心的“自动化驱动”能力正在向更广泛的领域扩展。1. Playwright for .NET, Java如果你团队的主力语言是C#或Java现在也可以享受到Playwright带来的便利API设计基本与Python/Node.js版本一致。2. Playwright Test Runner这是微软围绕Playwright构建的一个专门的测试运行器playwright/test它比单纯用Pytest集成提供了更多开箱即用的功能如并行化、HTML报告、Trace、视频录制、全局配置等。虽然主要面向Node.js但其设计理念值得Python生态借鉴。3. 移动端原生应用测试实验性Playwright团队正在探索通过其协议支持Android和iOS原生应用的自动化。虽然目前还不成熟但这预示着一个“大一统”的端到端自动化测试框架的可能性。4. 与AI结合社区已经出现了一些探索例如利用Playwright自动浏览网页收集数据结合LLM大语言模型进行内容分析和摘要。其稳定可靠的浏览器控制能力使其成为AI Agent与真实Web世界交互的“手和眼”。在我个人的技术选型中对于新的Web项目Playwright已经成为了UI自动化测试的首选。它的现代化设计、出色的性能、丰富的功能以及活跃的社区都让它站在了当前自动化测试工具链的顶端。从Selenium迁移过来可能需要一些学习成本但长期来看在测试稳定性、开发效率和维护成本上带来的收益是巨大的。
![华为OD机试2025C卷-字符串变换最小次数[100分]（ Java _ Python3 _ C++ _ C语言 _ JsNode _ Go）实现100%通过率](http://pic.xiahunao.cn/yaotu/华为OD机试2025C卷-字符串变换最小次数[100分]（ Java _ Python3 _ C++ _ C语言 _ JsNode _ Go）实现100%通过率)
![华为OD机试2025C卷-内存资源分配[100分]（ Java _ Python3 _ C++ _ C语言 _ JsNode _ Go）实现100%通过率](http://pic.xiahunao.cn/yaotu/华为OD机试2025C卷-内存资源分配[100分]（ Java _ Python3 _ C++ _ C语言 _ JsNode _ Go）实现100%通过率)
