codeceptjs/CodeceptJS

这是什么？

核心功能

• 01以用户视角的步骤编写测试，可在 Playwright、Puppeteer、WebDriver 等引擎间运行。
• 02通过 Appium 和 Detox helper 支持移动端测试。
• 03提供交互式 shell，可在测试中暂停并在浏览器中尝试命令。
• 04支持动态分配的并行测试执行。
• 05内置辅助编写与修复失败测试的 AI 功能和 HTML 报告器。
• 06提供生成测试与 Page Object 的命令行工具，并支持 TypeScript。

适用场景

• 为需要在多种浏览器引擎上运行的 Web 应用编写验收测试。
• 构建非工程人员也能看懂的端到端测试套件。
• 用 Detox 对 React Native 应用做灰盒测试。
• 将 Codeception 等框架的功能测试迁移到 Node.js。

快速上手

1. 1

   从 npm 安装 CodeceptJS

   npm i codeceptjs --save
2. 2

   在测试目录中初始化测试环境并选择辅助工具

   npx codeceptjs init
3. 3

   生成你的第一个测试

   npx codeceptjs generate:test
4. 4

   运行测试

   npx codeceptjs run

使用前须知

• !4.2 版本需要 Node.js 22.12.0 或更高版本。
• !README 中的 Appium 移动端构建状态仅列出 Android。

收录于专题

标签

常见问题

CodeceptJS 是什么？

基于 JavaScript 的端到端测试框架，用贴近用户视角的可读步骤编写网页与移动端测试。 CodeceptJS 是一个面向 Node.js 的端到端测试框架。测试用场景和一组简单步骤来编写，例如 amOnPage、fillField、see，读起来就像用户在操作页面。框架屏蔽了各种浏览器自动化 API 的差异，同一套测试语法可以运行在 Playwright、Puppeteer、WebDriver（基于 webdriverio）以及几种轻量无头浏览器上。

CodeceptJS 可以免费使用吗？用的什么许可证？

CodeceptJS 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

CodeceptJS 还在维护吗？

活跃维护中。CodeceptJS 最近一次提交是在 2026年11月6日。

CodeceptJS 适合用来做什么？

为需要在多种浏览器引擎上运行的 Web 应用编写验收测试。 构建非工程人员也能看懂的端到端测试套件。 用 Detox 对 React Native 应用做灰盒测试。 将 Codeception 等框架的功能测试迁移到 Node.js。

CodeceptJS 怎么安装和运行？

从 npm 安装 CodeceptJS: npm i codeceptjs --save 在测试目录中初始化测试环境并选择辅助工具: npx codeceptjs init 生成你的第一个测试: npx codeceptjs generate:test 运行测试: npx codeceptjs run

在哪里获取 CodeceptJS？

源代码和安装说明在 GitHub 上：https://github.com/codeceptjs/CodeceptJS