如何使用PKG将Playwright测试打包为单个可执行文件？

核心可行性说明 #

可以用PKG将Playwright测试打包成单可执行文件，但需要额外处理Playwright的二进制依赖（浏览器驱动、内核文件）——PKG默认仅打包JS文件，不会自动包含这些原生二进制资源。

具体实现步骤 #

1. 编写自定义入口脚本 #

不能直接复用npx playwright test命令，需手动写一个Node.js入口文件（比如run-tests.js），通过Playwright的测试运行器API来触发测试：

const { run } = require('@playwright/test');

(async () => {
  // 调用Playwright测试运行器，配置参数可根据项目调整
  const testResult = await run({
    config: './playwright.config.js',
    projects: ['chromium'],
    testFiles: ['./tests/**/*.spec.js']
  });

  // 根据测试结果设置进程退出码
  process.exit(testResult.status === 'passed' ? 0 : 1);
})();

2. 配置PKG的package.json #

在项目package.json中添加PKG专属配置，明确要打包的文件、资源及目标平台：

{
  "name": "playwright-test-bundle",
  "version": "1.0.0",
  "main": "run-tests.js",
  "pkg": {
    "scripts": [
      "tests/**/*.spec.js",
      "playwright.config.js"
    ],
    "assets": [
      "node_modules/playwright-core/**/*.js",
      "node_modules/playwright-core/.local-browsers/**/*"
    ],
    "targets": [
      "node18-win-x64",
      "node18-linux-x64",
      "node18-macos-x64"
    ]
  }
}

• scripts：指定要打包的测试脚本和配置文件
• assets：必须包含Playwright核心模块及预下载的浏览器二进制文件，这是测试运行的关键依赖
• targets：设置要打包的目标平台，按需调整Node.js版本和系统架构

3. 预下载Playwright浏览器 #

打包前确保已下载对应平台的浏览器，执行：

npx playwright install chromium firefox webkit

浏览器二进制文件会存放在node_modules/playwright-core/.local-browsers目录，PKG会将其纳入打包范围。

4. 执行PKG打包命令 #

直接运行PKG命令完成打包：

pkg .

打包完成后，项目根目录会生成对应平台的可执行文件（如Windows下的.exe、Linux/macOS下的可执行程序）。

5. 验证可执行文件 #

直接运行生成的文件，无需依赖Node.js环境即可自动执行测试：

# Windows环境
playwright-test-bundle.exe

# Linux/macOS环境
./playwright-test-bundle

注意事项 #

• 平台专属打包：PKG生成的可执行文件是平台特定的，需为每个目标平台单独打包
• 依赖版本同步：若更新Playwright版本，需重新下载浏览器并重新打包
• 路径兼容性：若测试中使用相对路径的资源（如测试数据），需将这些资源加入PKG的assets配置，或在代码中调整路径为可执行文件所在目录的相对路径

内容的提问来源于stack exchange，提问作者Duncan Groenewald