如何在pnpm monorepo中配置共享的CodeceptJS+Playwright实例

完全可以在pnpm workspace的monorepo中共享一套CodeceptJS+Playwright依赖，无需在每个子包重复安装。以下是具体实现步骤：

1. 根目录统一安装共享依赖 #

在项目根目录执行命令，将依赖安装到工作区全局：

pnpm add -w codeceptjs playwright @codeceptjs/configure

@codeceptjs/configure是可选依赖，用于更便捷地管理共享配置。

2. 配置子包的脚本命令 #

在每个需要使用CodeceptJS的子包（如package1、package2）的package.json中，添加调用根目录依赖的脚本：

{
  "scripts": {
    "test": "codeceptjs run",
    "test:init": "codeceptjs init",
    "test:ui": "codeceptjs ui"
  }
}

pnpm workspace会自动让子包优先使用根目录node_modules中的依赖，无需额外配置路径。

3. 初始化子包测试配置（避免本地安装） #

进入子包目录，直接运行自定义的初始化脚本：

pnpm test:init

此时不会触发"需要本地安装"的警告，因为子包通过pnpm workspace的依赖链路找到了根目录的CodeceptJS。

如果仍有警告，可以在子包的package.json中添加peerDependencies声明依赖（无需实际安装）：

{
  "peerDependencies": {
    "codeceptjs": "^3.5.0",
    "playwright": "^1.40.0"
  }
}

替换版本号为你实际安装的版本即可。

4. 优化：共享基础配置 #

为减少重复配置，可在根目录创建基础配置文件codecept.conf.base.js：

exports.config = {
  helpers: {
    Playwright: {
      browser: 'chromium',
      show: false,
      baseUrl: 'http://localhost:3000'
    }
  },
  include: {
    I: './steps_file.js'
  },
  mocha: {},
  bootstrap: null
};

然后在子包的codecept.conf.js中引入并扩展基础配置：

const baseConfig = require('../../codecept.conf.base.js');

exports.config = {
  ...baseConfig.config,
  tests: './tests/**/*.test.js', // 子包专属测试路径
  output: './test-output', // 子包专属输出目录
  name: 'package1' // 子包名称
};

5. 验证效果 #

在子包目录运行测试命令：

pnpm test

检查子包的node_modules目录，不会出现codeceptjs或playwright，说明确实使用了根目录的共享依赖。

为什么之前的操作有问题？ #

• 根目录执行pnpm dlx codeceptjs init只会生成根目录的配置，子包未关联该配置，因此无法识别框架；
• 直接在子包用pnpm dlx会触发临时下载逻辑，所以提示需要本地安装，而通过子包脚本调用根目录的依赖则不会触发该逻辑。

内容的提问来源于stack exchange，提问作者Lewis Munene