目录

Playwright v1.65.0 正式支持在 Bun 上运行测试运行器。现在可以用 Bun 运行测试,但由于文件监视行为和 TypeScript 配置存在差异,需要在更改 CI 前验证迁移。

要点#

  • Playwright v1.65.0 正式支持将 Bun 作为测试运行器的运行环境。
  • 由于 Bun 自行转译 TypeScript 测试文件,Playwright 不再使用 Babel 和编译缓存。
  • Watch Mode 不可用,UI Mode 不会在文件变更后自动重新运行测试。
  • --only-changed 选项存在限制,--tsconfig 在 Bun 上不生效。

支持 Bun 带来的变化#

此次变更涉及运行 Playwright 测试运行器的运行时。Node.js 仍然可用,Bun 则成为新增的正式支持选项。

对于 TypeScript 测试,执行流程会发生变化。Playwright 的版本说明中写道:

> 测试运行器现在可以在 Bun 上运行。由于 Bun 自行转译 TypeScript 测试文件,Playwright 不再使用 Babel 或编译缓存。

这让使用 Bun 的团队获得了在该环境中运行 Playwright 测试的正式支持。不过,这并不意味着可以使用与 Node.js 上的运行器完全相同的功能。请分别评估运行时支持和工作流兼容性。

TypeScript 处理方式为何重要#

在 Bun 上运行 Playwright 时,Bun 会将 TypeScript 测试文件转换为可执行的 JavaScript。因此,Playwright 不再使用 Babel 转换或编译缓存。

这些处理环节会从执行路径中移除,但这不足以证明所有测试套件都会提速。所提供的版本信息没有基准测试数据。浏览器启动、应用响应时间以及测试本身的处理都会影响总执行时间。

此外,转译不能替代 TypeScript 类型检查。如果项目单独运行类型检查,请在评估 Bun 期间继续执行。测试通过仅表明该测试正常运行,并不表示整个项目通过了类型检查。

如何评估切换#

请先从可重复的小规模对比开始。使用 Playwright v1.65.0,记录待验证的 Bun 版本,并确保每次运行使用相同的应用构建和浏览器版本。

1. 在现有 Node.js 环境中运行一组有代表性的测试,并保存结果。 2. 使用 v1.65.0 文档中记载的启动方式,在 Bun 上启动 Playwright 测试运行器,运行同一组测试。 3. 比较测试发现、通过与失败结果,以及测试套件中使用的初始化和清理操作的行为。 4. 在更改共享 CI 配置前,在 Bun 上运行完整测试套件。

对比时,请确认运行器实际使用的运行时。仅使用 Bun 安装依赖,并不代表 Playwright 运行器就在 Bun 上运行。如果将速度作为判断依据,请在同等条件下多次测量,并记录是否包含依赖和浏览器的安装时间。

工作流差异#

采用前需要注意以下四项限制。

  • Watch Mode: 在 Bun 上不可用,会影响依赖持续运行测试的工作流。
  • UI Mode: 文件变更后不会自动重新运行测试,交互式开发流程会因此改变。
  • `--only-changed`: 功能存在限制。在用它选择测试前,请查阅 v1.65.0 文档,确认是否符合用途。
  • `--tsconfig`: 在 Bun 上不生效,因此不要认为通过此标志选择的配置会得到应用。

如果测试命令显式选择了 TypeScript 配置,--tsconfig 的差异就尤为重要。不要假定现有命令会保持相同含义,请验证测试所需的行为,包括依赖该配置的导入。

主要在 CI 中运行完整测试套件的团队,可能较容易应对这些限制。依赖开发期间自动重新运行测试的团队,则需要检查更多事项。请根据实际工作流选择运行时,并在 Bun 通过对比验证前保留现有的 Node.js 命令。

后续步骤#

使用 Playwright v1.65.0 在 Bun 上运行一组有代表性的测试,与在 Node.js 上运行同一组测试的结果进行比较,然后再更改默认测试命令。

来源: https://www.publickey1.jp/blog/26/playwrightbun.html

目录