Cypress 是一种流行的基于 JavaScript 的端到端测试框架,旨在简化 Web 应用程序测试。在其各种功能中,cypress run 命令脱颖而出,成为持续集成和部署管道中自动化测试的重要工具。它允许您在无头环境或指定浏览器中运行测试,提供灵活性、速度和自动化功能。
在本文中,我们将深入探讨如何使用 cypress run、其选项、实际示例以及将其集成到测试工作流程中的最佳实践。
什么是 cypress run?
cypress run 命令使用默认的 Electron 浏览器或任何其他受支持的浏览器(例如 Chrome 或 Firefox)以无头模式执行 Cypress 测试。此命令专为自动化测试场景而定制,例如在 CI/CD 管道、夜间构建或任何不需要 GUI 的环境中运行测试套件。
与打开交互式测试运行器的 cypress open 命令不同,cypress run 是专门为自动化测试执行而设计的,使其成为现代开发工作流程中的关键工具。
为什么使用cypress run?
- 自动化测试:非常适合在 CI/CD 管道中无需手动干预即可运行测试。
- 快速执行:无头模式可减少开销,从而更快地完成测试。
- 跨浏览器支持:跨不同浏览器运行测试以进行兼容性检查。
- 调试工具:自动捕获屏幕截图和视频以进行调试。
- 并行测试:通过将测试分布在多台机器上来加快测试执行速度。
_______________________________________
cypress run 的基本语法
cypress run 命令的最简单形式是:
巴什
复制代码
npx 赛普拉斯运行
这个命令:
• 执行位于cypress/integration 文件夹中的所有测试文件。
• 在默认的Electron 浏览器中运行测试。
• 在无头模式下运行。
_______________________________________
常用的 cypress 运行选项
Cypress 提供了各种选项来自定义 cypress run 命令。以下是最有用的:
- 指定浏览器
在特定浏览器(例如 Chrome 或 Firefox)中运行测试:
巴什
复制代码
npx cypress run --chrome浏览器
- 运行特定的测试文件
专注于特定的测试文件或文件夹:
巴什
复制代码
npx cypress run --spec "cypress/integration/login.spec.js"
- 小组测试
对测试运行进行分类和标记,这在仪表板中特别有用:
巴什
复制代码
npx cypress run --group“回归测试”
- 记录结果
与 Cypress Dashboard 集成以记录和分析测试结果:
巴什
复制代码
npx cypress run --record --key YOUR_PROJECT_KEY
- 传递环境变量
在测试执行期间注入环境变量:
巴什
复制代码
npx cypress run --env ENV=staging,API_URL=https://staging.api.example.com
- 并行测试
在多台机器上运行测试以减少总体执行时间:
巴什
复制代码
npx cypress run --parallel --record --key YOUR_PROJECT_KEY
- 禁用视频
防止 Cypress 录制视频:
巴什
复制代码
npx cypress run --video false
_______________________________________
高级使用场景
在 CI/CD 管道中运行测试
Cypress 广泛用于 CI/CD 管道中的回归和冒烟测试。典型的设置可能如下所示:
巴什
复制代码
npx cypress run --record --key YOUR_PROJECT_KEY --spec "cypress/integration/*/.spec.js"
在自定义环境中运行测试
如果您对开发、登台和生产环境有不同的配置,则可以传递特定于环境的变量:
巴什
复制代码
npx cypress run --env ENV=生产
使用以下方法在测试脚本中访问这些变量:
javascript
复制代码
const apiUrl = Cypress.env('API_URL');
调试测试失败
添加 --headed 标志以查看在可见浏览器中运行的测试:
巴什
复制代码
npx cypress run --headed
要启用详细的调试日志:
巴什
复制代码
DEBUG=cypress:* npx cypress 运行
_______________________________________
实际示例命令
- 在 Chrome 中运行所有测试
巴什
复制代码
npx cypress run --chrome浏览器
- 并行执行测试
巴什
复制代码
npx cypress run --parallel --record --key YOUR_PROJECT_KEY
- 测试单个规格文件
巴什
复制代码
npx cypress run --spec "cypress/integration/cart.spec.js"
- 使用环境变量运行测试
巴什
复制代码
npx cypress run --env 用户名=admin,密码=秘密
_______________________________________
cypress run 的调试技巧
如果测试失败或表现异常,请考虑以下故障排除技术:
- 检查测试日志:使用详细日志记录来查明错误。
- 查看屏幕截图和视频:Cypress 会自动保存失败测试的屏幕截图和视频。
- 增加测试超时:如果测试因超时而失败,请增加 cypress.json 文件中的值:
json
复制代码
{
“默认命令超时”:10000
}
- 重试 Flaky 测试:在 cypress.json 中启用重试:
json
复制代码
{
“重试”:2
}
_______________________________________
使用 cypress run 的最佳实践
- 与 CI/CD 管道集成:自动测试每个代码推送或部署。
- 使用并行执行:将测试分布在多台机器上以减少执行时间。
- 利用 Fixtures:使用模拟数据来避免对外部 API 的依赖。
- 优化测试:消除不必要的等待并确保测试隔离且可靠。
- 监控结果:利用赛普拉斯仪表板进行详细的见解和趋势分析。
_______________________________________
结论
cypress run 命令是一个用于自动化和简化测试过程的强大工具。无论您是将其集成到 CI/CD 管道中、跨多个环境运行测试还是调试复杂的场景,cypress run 都提供了确保稳健且高效的测试所需的灵活性和功能。
通过掌握其用法和最佳实践,您可以显着增强您的测试策略并充满信心地交付高质量的软件。立即开始利用 cypress run 来释放 Cypress 在您的开发工作流程中的全部潜力。
以上是cypress run 综合指南:自动化您的测试工作流程的详细内容。更多信息请关注PHP中文网其他相关文章!