FDE Times 数据在招 FDE 职位 873▼9 近 7 天在招职位数的变化(同口径比较):不计入本周新开始追踪的公司的职位近 7 天新增 55在招公司 181支持远程 25%美国薪资中位数 $200k招聘最多 Databricks 98
ENVI

前线部署工程师(FDE)的专业媒体

工具

交付在客户那边到底能不能用?让 trace 来回答

Playwright trace 记录每一步操作和每个网络请求,客户打开就能看到流程是怎么跑的。

分享微博

要点速览

  • Playwright Test 集成了运行器、断言、测试隔离和并行执行,用 npm init 即可安装。
  • Trace Viewer 展示每个操作的定位器和耗时、DOM 快照以及所有网络请求。
  • 在 CI 中为首次重试开启 trace,客户问交付能不能用时,就拿 trace 作为证据。
前后对比图。左侧是“之前”:只有一张截图和各自的记忆,沟通卡在“你的代码有问题”这一句。右侧是“之后”:一个 Playwright trace 文件,分为三部分:Actions(locator、耗时)、DOM 快照(点击时)和 Network(全部请求)。Network 部分用橙色高亮,并引出一行结论:“API 在上午 9 点返回了错误”。
只有截图时,沟通很容易变成互相甩锅。trace 文件记录了每个操作的 locator 和耗时、点击那一刻的 DOM 快照以及每一个网络请求,双方可以对着同一个具体的技术故障来讨论。

周五,你完成了与客户 Web 门户的集成。周一,客户发来消息:“申请表单用不了。”你手里只有一张截图和自己的记忆,对方那边则是一个满肚子火的用户。

“在我机器上是好的”这种说法,最容易让前线部署工程师(FDE)失去信任,而这正是 Playwright 要解决的问题。你写一个测试,像真实用户一样把整个流程走一遍,每次运行都会留下记录,双方都能打开查看。

对于在客户系统里工作的人来说,这是一项部署技能,不该丢给 QA 团队。你需要一种可重复的方式来说明“这个流程是通的”,并拿出证据。

这是什么工具,为什么选它?

Microsoft 官方文档把 Playwright Test 定义为面向现代 Web 应用的端到端测试框架。它的 GitHub 仓库归属 microsoft 组织,采用 Apache-2.0 许可证,描述更宽泛:一个用于 Web 测试和自动化的框架。

对 FDE 来说,最大的好处是一个包里什么都有:运行器、断言、测试之间的隔离、并行执行以及配套工具。用 npm init playwright@latest 就能装好,不必在客户的笔记本上东拼西凑好几个库。它支持 Chromium、WebKit 和 Firefox,可以在 Windows、Linux 和 macOS 上运行。

所以,客户有 Safari 用户也好,对方 IT 只给你一台 Windows 机器也好,同一套测试都能直接跑,不用重写。

为刚交付的流程写一个最小测试

设想你刚上线的流程:用户登录,填写申请表单,点击提交,看到确认信息。测试只需沿着这条路径走:

import { test, expect } from '@playwright/test';

test('成功提交申请', async ({ page }) => {
  await page.goto('https://portal.example.com/login');
  await page.getByLabel('Email').fill('[email protected]');
  await page.getByLabel('Password').fill(process.env.DEMO_PASSWORD!);
  await page.getByRole('button', { name: 'Sign in' }).click();

  await page.getByRole('link', { name: 'New request' }).click();
  await page.getByLabel('Details').fill('End-to-end check');
  await page.getByRole('button', { name: 'Submit' }).click();

  await expect(page.getByText('Request received')).toBeVisible();
});

这个测试里没有一个 sleep,这是有意为之。执行操作前,Playwright 会等待相关的可操作性检查通过;超时后仍未通过,就抛出 TimeoutError。客户页面加载慢、第三方脚本又多,这种自动等待能让测试更稳定。

最后一行是 web-first 断言。按照最佳实践指南的说法,这类断言会一直等到预期条件满足。你检查的是用户看到的东西,而不是内部细节。

trace 是证据,不只是调试工具

Trace Viewer 是一个图形界面工具,用来在脚本运行后查看录制下来的 trace。thoughtbot 的 Justin Toniazzo 把它比作测试运行的“录像机”,并认为开启它几乎不费什么力气。

官方文档建议在 CI 上、失败测试首次重试时录制 trace。配置只需几行:

// playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
  retries: 1,
  use: { trace: 'on-first-retry' },
});

回到周一那条消息。打开 trace,进入 Actions 面板,这里显示每个操作用的定位器和耗时。假设点击“Submit”几乎耗尽了整个超时时间,你就知道该从哪里查起了。

接着,每个操作都有 DOM 快照,可以看到点击那一刻页面的样子。Network 面板列出测试运行期间的所有请求。如果表单提交时客户后端返回了错误,对话就从“你的代码坏了”变成“这个 API 在 9 点返回了错误”,这是双方都能着手解决的技术问题。

trace 可以用一条 CLI 命令在本地打开,也可以用 trace.playwright.dev,这是 Trace Viewer 的静态托管版本,直接在浏览器里运行。客户那边的人没装 Node 环境时,这一点很方便。

刚开启 trace 时的常见错误

最常见的错误是设置了 trace: 'on-first-retry',却忘了 retries。没有重试就没有“首次重试”,测试失败时不会留下任何 trace,而这恰恰是最需要它的时候。在相信 CI 正在录制之前,先检查配置里的这两行。

相反的错误是为了保险,每次运行都开 trace。每个 trace 包含每个操作的 DOM 快照和每个网络请求,把整个通过的测试套件都录下来,只会产生一堆几乎没人打开的大文件。

第三个错误要回到上面的代码:测试不稳定时加 sleep。这只会掩盖症状,还拖慢整个套件。Playwright 本来就会等操作就绪,测试仍然失败时,应该打开 trace 看哪一步慢,而不是再多等几秒。

要向客户讲清楚的局限

测试通过,只能证明这个流程在那个环境、那份数据、那个时刻是通的。它不能替代单元测试,也不能替代生产环境监控。承诺得比这更多,下次 trace 本身就会让你失去信任。

trace 包含 DOM 快照和网络请求,很可能带有客户的真实数据。把 trace 上传到任何地方或通过聊天工具发送之前,先问清对方的数据政策。最好用演示账号和假数据跑测试。

TimeoutError 也只能告诉你某个条件没有满足,不能告诉你原因。真正的工作仍是阅读 trace 并推理,这项技能需要练习。

先学什么,怎么写进简历

合理的顺序是:基于角色和标签的定位器、web-first 断言、CI 上的 trace 配置,然后是读懂 trace 里的三样东西:Actions、快照和 Network。先把这四项练扎实,再考虑并行运行或多浏览器。

看 FDE 招聘启事时,留意那些讲端到端负责部署、在客户环境中调试的段落。你的 Playwright 经历就该放在这里。

简历上写一句“为用户引导流程编写端到端测试,并用 CI trace 定位客户 API 中的缺陷”,远比“熟悉 Playwright”更有分量。

下次客户问你的交付能不能用,不必争辩,发一个 trace 文件过去就行。

这篇文章对你有帮助吗?

6 个信源
路线图上的下一篇 · 阶段 5: 部署上线让 Helm chart 先在笔记本上出错,别等到客户集群kind 一条命令就能用 Docker 容器搭出 Kubernetes 集群,正式安装前就能发现 chart 错误。