cypress-io avatar

cypress-io/github-action

1.5k 355 33
JavaScript MIT
创建于 6 年前 最后更新 5 天前

AI 综合评分

61 B 级
代码质量
56
文档质量
63
社区健康
59
项目活跃
66
创新性
54

项目简介

在 GitHub Actions 中运行 Cypress 端到端和组件测试的官方 Action。

项目摘要

【主题】

一键将 Cypress 测试嵌入 GitHub Actions 流水线,自动化测试无痛入门。

【核心分点总结】

  1. 零配置上手:只需指定 Cypress 版本,自动安装、运行并缓存依赖,无需手动处理 Node 或 Cypress 安装。

  2. 智能并行与负载均衡:自动将测试分散到多个 Runner 上,缩短 CI 执行时间,支持 record 模式对接 Cypress Dashboard。

  3. 灵活报告与调试:内置 artifact 上传测试截图/视频,提供 working-directorybrowserconfig-file 等参数适配复杂项目结构。

  4. 组件测试兼容:不仅支持 e2e,还支持 Cypress 组件测试,统一前端测试工具链。

【行动指南】

  1. 快速集成:在你的 .github/workflows 中添加 uses: cypress-io/github-action@v6,并指定 working-directory(如需),立即生效。
  2. 并行加速:如果你有大量测试且多个 Runner,开启 record: true 并设置 Cypress 项目 ID 和密钥,自动分配测试到各节点。
  3. 调试场景:若测试失败需要排查,确保 screenshotsvideo 输出被上传为 artifact,后续在 Action 页面即可查看截图或视频回放。

【金句总述】

从此,Cypress 测试不再是 CI 配置的噩梦——一行 Action,终身托管。

【故事性收尾】

以前,每次 CI 测试失败你都得翻日志、猜环境差异。现在,打开 GitHub Action 页面,看到测试截图和视频自动挂在 Artifacts 区,就像有个人形 Cypress 坐在你身边,指着屏幕说:“看,就是这里翻了车。”

相关项目推荐