告别测试依赖噩梦：Playwright Python外部服务Mock完全指南
项目地址: https://gitcode.com/GitHub_Trending/pl/playwright-python 你是否还在为测试环境中的外部服务依赖而头疼？第三方API不稳定、支付系统无法在测试环境调用、天气接口返回数据不可控——这些问题常常让自动化测试变得脆弱且难以维护。本文将带你掌握Playwright Python中强大的网络拦截能力，通过Mock与Stub技术彻底解决外部服务依赖问题，让你的测试用例真正实现"一次编写，到处运行"。
读完本文你将学会：
- 使用Playwright拦截任意网络请求
- 构建灵活的Mock服务响应
- 实现条件化请求处理逻辑
- 结合实际场景设计可维护的测试隔离方案
为什么需要Mock外部服务
在现代应用架构中，几乎没有系统是完全独立的。你的应用可能需要调用支付网关、地图服务、天气API等第三方服务，或者依赖内部的用户认证、数据分析等微服务。这些外部依赖给自动化测试带来了诸多挑战：
- 环境不稳定性：第三方服务可能随时不可用或返回异常数据
- 数据一致性：无法保证每次测试都能获得相同的响应结果
- 成本问题：某些API调用可能产生费用（如支付接口）
- 权限限制：测试环境可能无法访问生产环境的服务端点
Playwright的网络拦截功能正是解决这些问题的利器。通过在浏览器层面拦截请求，我们可以完全控制响应内容，无需修改应用代码即可实现测试隔离。
Playwright网络拦截基础
Playwright提供了强大而灵活的网络拦截API，允许你注册路由处理函数来控制页面发出的任何网络请求。核心API包括：
page.route(url, handler): 注册请求处理函数route.fulfill(): 返回自定义响应route.continue_(): 继续处理原始请求route.abort(): 中止请求
这些API在playwright/sync_api/_generated.py中有详细定义，其中Route类的fulfill方法支持多种响应配置方式。
基础拦截示例
以下是一个简单的请求拦截示例，它将所有对empty.html的请求替换为自定义响应：
def test_request_fulfill(page: Page, server: Server) -> None:
def handle_request(route: Route, request: Request) -> None:
# 验证请求信息
assert "empty.html" in request.url
assert request.method == "GET"
# 返回自定义响应
route.fulfill(
status=200,
content_type="text/plain",
body="Mocked response"
)
# 注册路由处理器
page.route("**/empty.html", handle_request)
# 触发请求
response = page.goto(server.EMPTY_PAGE)
assert response
assert response.status == 200
assert response.text() == "Mocked response"
这段代码来自tests/sync/test_network.py，展示了Playwright同步API的基本用法。对于异步代码，可以使用类似的async处理函数。
实战：构建Mock服务响应
让我们通过几个实用场景来深入了解Playwright的Mock能力。
1. 模拟JSON API响应
在测试依赖JSON API的功能时，我们可以轻松模拟完整的API响应：
def test_mock_json_response(page: Page) -> None:
def handle_products(route: Route) -> None:
# 模拟产品列表API响应
route.fulfill(
status=200,
content_type="application/json",
json={
"products": [
{"id": 1, "name": "Playwright Mug", "price": 19.99},
{"id": 2, "name": "Playwright T-Shirt", "price": 29.99}
],
"total": 2
}
)
# 拦截/products请求
page.route("**/api/products", handle_products)
# 访问应用页面
page.goto("/product-list")
# 验证模拟数据是否正确显示
assert page.locator(".product-item").count() == 2
assert page.locator(".product-name").nth(0).text_content() == "Playwright Mug"
这种方式特别适合测试前端界面在不同数据状态下的表现，例如空列表、加载错误、分页数据等场景。
2. 模拟文件响应
除了动态生成响应，Playwright还支持直接从文件加载响应内容：
def test_mock_from_file(page: Page) -> None:
def handle_route(route: Route) -> None:
# 从文件加载模拟数据
route.fulfill(
path="tests/assets/mock_data.json",
content_type="application/json"
)
page.route("**/api/complex-data", handle_route)
# ...测试逻辑...
这种方法适合响应内容较大或结构复杂的场景，测试数据可以与代码分离管理。项目中的tests/assets/simple.json就是一个典型的模拟数据文件示例。
3. 条件化响应处理
实际测试中，我们可能需要根据请求参数返回不同的响应。以下示例展示了如何根据查询参数动态调整响应：
def test_conditional_mock(page: Page) -> None:
def handle_search(route: Route) -> None:
# 获取请求查询参数
url = route.request.url
params = urlparse(url).query
query = parse_qs(params).get("q", [""])[0]
# 根据查询参数返回不同响应
if query == "playwright":
route.fulfill(
json={"results": [{"id": 1, "name": "Playwright Python"}]},
content_type="application/json"
)
else:
route.fulfill(
json={"results": []},
content_type="application/json"
)
page.route("**/api/search", handle_search)
# 测试存在结果的场景
page.goto("/search?q=playwright")
assert page.locator(".search-result").count() == 1
# 测试无结果的场景
page.goto("/search?q=selenium")
assert page.locator(".no-results").is_visible()
这种条件化处理能力使得我们可以在单个测试用例中验证多种场景，大大提高测试效率。
高级Mock技巧
1. 修改原始响应
有时我们不需要完全替换响应，而是对原始响应进行修改。这时可以使用route.fetch()方法：
def test_modify_response(page: Page) -> None:
def handle_route(route: Route) -> None:
# 获取原始响应
response = route.fetch()
# 解析并修改响应数据
data = response.json()
data["features"].append("Mocked Feature")
# 返回修改后的响应
route.fulfill(
response=response,
json=data
)
page.route("**/api/features", handle_route)
# ...测试逻辑...
这种技术特别适合测试"部分数据修改"的场景，同时保留原始响应的大部分结构和内容。
2. 模拟图片响应
除了API响应，Playwright还可以模拟图片等二进制资源。项目中的tests/assets/pptr.png就是一个用于测试的图片资源，我们可以在测试中这样使用它：
def test_mock_image(page: Page) -> None:
def handle_image(route: Route) -> None:
# 返回测试图片
route.fulfill(
path="tests/assets/pptr.png",
content_type="image/png"
)
# 拦截所有图片请求
page.route("**/*.png", handle_image)
page.goto("/gallery")
# 验证图片是否加载成功
assert page.locator("img").first.is_visible()
通过模拟图片响应，我们可以确保测试不受外部图片资源变化的影响，同时加快测试执行速度。
3. 模拟错误场景
测试错误处理能力同样重要。Playwright可以轻松模拟各种错误场景：
def test_mock_errors(page: Page) -> None:
# 模拟服务器错误
def handle_500(route: Route) -> None:
route.fulfill(status=500, content_type="text/plain", body="Internal Server Error")
# 模拟未授权错误
def handle_401(route: Route) -> None:
route.fulfill(status=401, content_type="text/plain", body="Unauthorized")
# 模拟网络错误
def handle_abort(route: Route) -> None:
route.abort("connectionrefused")
page.route("**/api/error", handle_500)
page.route("**/api/auth", handle_401)
page.route("**/api/unreachable", handle_abort)
# 测试各种错误场景的UI表现...
这种全面的错误模拟能力确保你的应用在各种异常情况下都能正确处理。
测试最佳实践
1. 作用域管理
为避免路由处理函数相互干扰，建议使用page.context.route()或with page.expect_request()来限制路由的作用范围：
def test_scoped_route(page: Page) -> None:
# 临时路由：仅在with块内有效
with page.context.route("**/api/temp", lambda route: route.fulfill(body="temp")):
response = page.goto("/api/temp")
assert response.text() == "temp"
# 路由已自动清除
response = page.goto("/api/temp")
assert response.status == 404 # 原始响应
2. 路由优先级
当多个路由规则匹配同一个请求时，更具体的URL模式会优先匹配：
# 更具体的路由先注册，也会先匹配
page.route("**/api/users/*", handle_user)
# 更通用的路由后注册，仅匹配未被更具体路由处理的请求
page.route("**/api/*", handle_api)
3. 清理路由
虽然Playwright会在页面关闭时自动清理路由，但在单个测试中注册的路由可能会影响后续测试。建议在teardown阶段显式清理：
def test_cleanup_route(page: Page) -> None:
route = page.route("**/api", handle_api)
# 测试代码...
# 手动移除路由
route.unroute()
结语
Playwright的网络拦截能力为前端测试提供了强大支持，使我们能够构建真正隔离、稳定且高效的测试套件。无论是模拟简单的API响应，还是构建复杂的条件化路由规则，Playwright都能满足你的需求。
通过本文介绍的技术，你可以：
- 彻底消除测试对外部服务的依赖
- 精确控制测试数据和场景
- 显著提高测试执行速度
- 测试各种异常场景和边界情况
项目中还有更多网络测试的示例代码，如tests/async/test_network.py中的异步测试用例，以及examples/todomvc/mvctests/test_persistence.py中对本地存储的测试，可以作为进一步学习的参考。
掌握这些Mock与Stub技术，将使你的自动化测试质量提升到一个新的水平，让你能够自信地交付高质量的Web应用。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
