从 Selenium 迁移到 Playwright：升级你的测试框架实战手册

关注 霍格沃兹测试学院公众号，回复「资料」, 领取人工智能测试开发技术合集

如果你已经在使用 Selenium 进行 Web 自动化测试，可能会注意到近年来 Playwright 的崛起。这不是简单的替代关系，而是一次测试能力的全面升级。我在去年带领团队完成从 Selenium 到 Playwright 的迁移后，测试执行速度提升了40%，代码维护成本降低了30%。更重要的是，那些曾经令人头疼的等待问题、不稳定性问题，都得到了显著改善。

核心差异：不仅仅是语法变化
在开始迁移前，理解两个框架的本质差异至关重要：

Selenium 像是一个翻译官——它将你的指令翻译成不同浏览器的原生API调用，中间经过WebDriver协议。这个额外的抽象层虽然带来了广泛的浏览器支持，但也增加了复杂性和不稳定性。

Playwright 则像是直接与浏览器对话——它通过DevTools协议直接控制浏览器，支持Chromium、Firefox和WebKit三大引擎，提供了更一致、更可靠的执行环境。

迁移准备：三步走策略
第一步：环境评估与规划
在开始编码迁移之前，花时间评估当前测试状态：

统计现有测试用例数量和复杂度
识别重度依赖 Selenium 特性的部分
规划迁移顺序（建议从简单的测试开始）
第二步：环境搭建

卸载旧依赖

pip uninstall selenium

安装 Playwright

pip install playwright pytest-playwright

安装浏览器

playwright install chromium firefox webkit
第三步：基础配置迁移
将原来的 Selenium 配置转换为 Playwright 的配置文件：

原来的 Selenium 配置

from selenium import webdriver

options = webdriver.ChromeOptions()

options.add_argument('--headless')

driver = webdriver.Chrome(options=options)

Playwright 配置

import asyncio
from playwright.async_api import async_playwright

asyncdef create_browser():
asyncwith async_playwright() as p:
browser = await p.chromium.launch(headless=False)
context = await browser.new_context()
page = await context.new_page()
return browser, page
核心API迁移对照表
浏览器初始化
Selenium方式：

from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

driver = webdriver.Chrome()
wait = WebDriverWait(driver, 10)
Playwright方式：

from playwright.sync_api import Page, expect

自动等待内置于大多数操作中

page.wait_for_timeout(1000) # 尽量避免使用，利用自动等待
元素定位与操作
点击元素：

Selenium

element = driver.find_element(By.ID, "submit-btn")
element.click()

Playwright (更简洁)

page.click("#submit-btn")

或者使用更明确的选择器

page.get_by_role("button", name="提交").click()
输入文本：

Selenium

search_box = driver.find_element(By.NAME, "q")
search_box.send_keys("Playwright 教程")

Playwright

page.fill("input[name='q']", "Playwright 教程")

或者

page.get_by_placeholder("搜索...").fill("Playwright 教程")
等待策略迁移
这是迁移中最需要调整思维的地方：

Selenium 显式等待

element = WebDriverWait(driver, 10).until(
EC.presence_of_element_located((By.ID, "dynamic-element"))
)

Playwright 自动等待（推荐）

page.wait_for_selector("#dynamic-element", state="visible")

或者更优雅的：

expect(page.locator("#dynamic-element")).to_be_visible()
处理弹窗和对话框

Selenium（需要配置期望）

alert = driver.switch_to.alert
alert.accept()

Playwright（监听对话框）

page.on("dialog", lambda dialog: dialog.accept())
page.click("#trigger-alert")
Playwright mcp技术交流群

高级特性迁移指南

1. 页面切换管理

Playwright 的上下文管理更清晰

async with await browser.new_context() as context:
page = await context.new_page()
await page.goto("https://example.com")
# 打开新标签页
async with await context.new_page() as new_page:
await new_page.goto("https://another-site.com")
2. 网络请求拦截
Playwright 的网络请求控制能力强大得多：

拦截特定请求

await page.route("**/api/*", lambda route: route.fulfill(
status=200,
content_type="application/json",
body='{"success": true}'
))

修改请求头

await page.route("**/*", lambda route: route.continue_(headers={
**route.request.headers,
"X-Custom-Header": "value"
}))
3. 文件上传下载

文件上传（不再需要复杂的 send_keys）

async with page.expect_file_chooser() as fc_info:
await page.click("#upload-button")
file_chooser = await fc_info.value
await file_chooser.set_files("myfile.pdf")

下载文件

async with page.expect_download() as download_info:
await page.click("#download-button")
download = await download_info.value
await download.save_as("downloaded_file.pdf")
迁移常见问题与解决方案
问题1：自定义等待条件怎么办？

原来的 Selenium 自定义等待

def element_has_class(locator, class_name):
def _predicate(driver):
element = driver.find_element(*locator)
return class_name in element.get_attribute("class")
return _predicate

Playwright 解决方案

async def wait_for_class(page, selector, class_name, timeout=10000):
await page.wait_for_function(
"""([selector, className]) => {
const el = document.querySelector(selector);
return el && el.classList.contains(className);
}""",
[selector, class_name],
timeout=timeout
)
问题2：如何处理 Shadow DOM？

Playwright 原生支持 Shadow DOM

shadow_host = page.locator("#shadow-host")
shadow_root = shadow_host.element_handle().evaluate_handle("el => el.shadowRoot")
shadow_element = shadow_root.query_selector(".inner-element")
问题3：并行测试怎么处理？

Playwright 的 BrowserContext 是天然隔离的

import pytest

@pytest.fixture(scope="function")
async def page(browser):
context = await browser.new_context()
page = await context.new_page()
yield page
await context.close()

可以在不同的上下文中并行执行测试

性能优化技巧
重用浏览器实例：创建多个上下文而不是多个浏览器
合理使用 headless 模式：CI/CD 环境中使用 headless
视频录制选择性开启：只在失败的测试中录制视频
优化截图策略：只在需要时截图，使用 full_page=True 参数控制

配置示例

browser = await chromium.launch(
headless=True,
args=['--disable-dev-shm-usage']
)

context = await browser.new_context(
viewport={'width': 1920, 'height': 1080},
record_video_dir='videos/' if config.record_video else None
)
迁移检查清单
[ ] 更新依赖项和配置文件
[ ] 重写浏览器初始化逻辑
[ ] 更新元素定位器（优先使用角色和文本定位器）
[ ] 替换显式等待为 Playwright 的自动等待模式
[ ] 更新文件操作相关代码
[ ] 重写弹窗和对话框处理逻辑
[ ] 更新测试报告集成
[ ] 配置 CI/CD 流水线支持
[ ] 建立性能基准并对比
迁移后的收益
完成迁移后，你将会发现：

稳定性显著提升：减少了约60%的 flaky tests
执行速度加快：平均测试执行时间减少30-50%
代码更简洁：代码行数通常减少40%
调试更方便：内置的追踪和截图功能强大
跨浏览器测试更可靠：真正的多浏览器支持
开始你的迁移之旅
迁移不是一夜之间完成的。建议采取渐进式迁移策略：先从简单的测试用例开始，积累经验后再处理复杂的测试。建立迁移的节奏——比如每周迁移10%的测试用例，同时保持原有 Selenium 测试的正常运行。

记住，迁移不仅仅是技术替换，更是测试理念的升级。Playwright 提供的不仅是新的 API，更是更现代化、更可靠的测试方法论。开始迁移吧，你会发现自己不仅获得了更好的工具，也成为了更好的自动化测试工程师。

最好的迁移时间是一年前，其次是现在。

推荐学习
人工智能测试开发线下周末私教训练营马上开营啦！！！内容全面升级，AI测试专家带队，实战落地智能化测试！覆盖大模型应用、RAG测试用例生成、视觉自动化测试等核心内容。私教陪跑+闯关式学习，搭配大厂真实案例。保涨薪保就业，赠智能体SaaS工具，助你快速掌握AI测试开发技能。