Skip to content

Smoke 请求隔离 fixture ​

把同目录 smoke.fixture.ts 复制到项目测试目录,smoke spec 统一从它导入 test/expect。项目自己维护 @playwright/test 和浏览器安装;新工具不会安装它们。这是可审阅、可修改的源码示例,不是核心运行时插件,也没有模板自动更新机制。

ts
import { test, expect } from './smoke.fixture';

test('订单列表', async ({ page }) => {
  await page.route('**/api/orders', route => route.fulfill({
    json: { orders: [{ id: 'demo', title: '示例订单' }] },
  }));
  await page.goto('/orders');
  await expect(page.getByText('示例订单')).toBeVisible();
});

项目在原生 Playwright 配置中设置 baseURL,必要时使用 webServer 启动自己的开发服务。上面的路径、响应和断言是示例,必须替换为真实业务。smoke 与真实接口 integration 使用独立 spec/scripts;integration 从原生 @playwright/test 导入,并显式准备服务与账号。

fixture 自动安装 context 级兜底路由,覆盖该 context 内页面的 XHR/fetch。未被项目 mock 接管的请求先 abort,再在测试结束时断言失败;业务代码即使 catch 请求错误,也不能把 smoke 判为通过。普通页面/静态资源继续加载。fixture 阻止 Service Worker,并拒绝测试覆盖成 allow。诊断仅记录方法、origin 和 pathname,不记录请求 query、body 或 URL 凭据;业务测试自己的日志及原生 runner 的源码片段仍可能包含敏感信息,应避免硬编码。

Mock 使用 route.fulfill;不处理的请求使用 route.fallback 交给兜底 guard。不要使用 route.continue 或 route.fetch 作为 mock,它们可能绕过兜底路由触达网络。页面路由优先于 context 路由,后注册的 context 路由也可能覆盖 guard;本 fixture 不通过静态扫描审计测试代码,使用项目测试的可信代码约束。

此 guard 不是完整网络沙箱:不拦截 Node/APIRequestContext 请求、WebSocket、导航、静态资源等其他流量,也不覆盖新建的其他 browser context。需要这些请求隔离时应单独制定网络策略;不能据此宣称旧 smoke-layer 的所有检查已经等价迁移。

已用 Chromium 验证:fulfill 通过、未 mock fetch/XHR/新页面请求失败、fallback 仍被兜底拦截、Service Worker 覆盖配置被拒绝,并由本地 HTTP server 确认 API 请求没有到达。尚未替代真实业务 UI、登录与 App/WebView 验收。

原生行为依据:Playwright routing、route.fallback、route.fetch。兼容性以本包固定 Playwright 版本的实际测试为准。