如何使用CodeceptJS、Playwright和GitHub Actions构建端到端测试流水线

àì夳堔傛蜴生んèń 2024-02-20 12:22 29阅读 0赞

![2b3de9ea6bff450696d634f9281ae061.png][]

端到端测试是软件开发的一个重要方面，因为它确保系统的所有组件都能正确运行。CodeceptJS是一个高效且强大的端到端自动化框架，与Playwright 结合使用时，它成为自动化Web、移动甚至桌面 (Electron.js) 应用程序比较好用的工具。

在本文中，作者探讨如何使用 CodeceptJS、Playwright 和 GitHub Actions 构建端到端测试流水线。

### **GitHub操作** ###

GitHub Actions 是一个功能强大且灵活的 CI/CD 平台，能够让软件开发工作实现自动化。借助 GitHub Actions，大家可以直接在 GitHub 存储库中快速自动化你的开发、测试或操作流程。GitHub Actions 与 CodeceptJS 和 Playwright 无缝集成，为项目的测试自动化需求提供可靠的解决方案。

### **准备环境** ###

从配置环境变量开始，这些环境变量将定义流水线的运行方式以及控制其行为。通常项目运行多个环境，因此我们将定义`BASE_URL`变量作为在运行环境之间交替的最小值。

导航到 GitHub 存储库设置，然后在**Secrets and Variables**部分下选择**Actions**。单击**“变量”**选项卡将显示此存储库的所有变量的列表。

![图片][651f90c533df0a6f71c4f6054e0046f2.png]

GitHub存储库环境变量设置

单击**“新存储库变量”（New repository variable）**进行创建，BASE\_URL该变量会将测试自动化指向您的 Web 应用程序 URL。

可以使用环境变量实现的其他有用设置：

*  `HEADLESS=true`\- 在流水线内运行无头模式或在本地计算机上运行无头模式来调试测试场景。
 *  `DEVICE_SCALE_FACTOR=1`\- 在本地开发测试场景时避免屏幕闪烁（对于 MacBook 屏幕使用 2）。
 *  `ACCESSIBILITY=true`\- 在端到端测试中包含可访问性报告。
 *  `RECORD_HAR=true`\- 在 HTTP 存档中记录网络流量以用于调试目的。

### **流水线** ###

创建一个 YAML 格式的新文件来配置流水线并将其放入**.github/workflows**文件夹中。

// e2e-test-automation.yml
    jobs:
      test-automation:
        timeout-minutes: 30
        runs-on: ubuntu-latest
        container:
          image: mcr.microsoft.com/playwright:v1.38.1-jammy
    
        steps:
          - uses: actions/checkout@v4
          - uses: actions/setup-node@v3
            with:
              node-version: 'latest'
    
          - name: Install dependencies
            run: npm ci
    
          - name: Run test automation
            run: npm run test
            env:
              BASE_URL: ${
       { vars.BASE_URL }}
              HEADLESS: ${
       { vars.HEADLESS }}
              OUTPUT_PATH: output
    
          - uses: actions/upload-artifact@v3
            if: always()
            with:
              name: artifacts
              path: output
              retention-days: 30

### **多种浏览器** ###

在 CodeceptJS 配置文件中定义 Web 浏览器配置文件。

// codecept.conf.ts
    {
     //...
     multiple: {
       desktop: {
           browsers: [
           { browser: 'chromium' },
           { browser: 'firefox' },
           { browser: 'webkit' }
         ]
       },
     },
     //...
    }

为每个浏览器配置文件创建单独的 npm 脚本。

// package.json
    "test:chrome": "npx codeceptjs run-multiple desktop:chromium --steps",
    "test:firefox": "npx codeceptjs run-multiple desktop:firefox --steps",
    "test:safari": "npx codeceptjs run-multiple desktop:webkit --steps",

这种运行 CodeceptJS 场景的方式将为测试运行者尝试执行的每个步骤提供详细的反馈。

### **并行测试运行** ###

为了使该过程更加高效，请使用多个工作线程并行运行测试场景。

// package.json
    "test:chrome": "npx codeceptjs run-workers 3 desktop:chromium",
    "test:firefox": "npx codeceptjs run-workers 3 desktop:firefox --steps",
    "test:safari": "npx codeceptjs run-workers 3 desktop:webkit --steps"

CodeceptJS 将仅显示失败场景的详细步骤，这是大多数情况下所需要的。

### **使用一致的帮助程序依赖项** ###

在本例中，我们使用 Playwright 作为 CodeceptJS 帮助程序，因此请确保 Playwright npm 包版本与流水线中的 Docker 映像版本匹配。

// package.json
    "devDependencies": {
      ...
      "codeceptjs": "^3.5.5",
      "playwright": "^1.38.1",
      ...
    }

仔细检查 GitHub Actions 流水线配置中的 Docker 映像版本。

// e2e-test-automation.yml
    jobs:
      test-automation:
        timeout-minutes: 30
        runs-on: ubuntu-latest
        container:
          image: mcr.microsoft.com/playwright:v1.38.1-jammy

如果版本不一致，将失败，并显示一条不太明显的消息。

![图片][2ce0eec5bb89b04364d0b21bdb472c20.png]

包含 Playwright 错误消息的 GitHub Actions 日志

### **每个浏览器都有一个单独的工作** ###

在单独的 GitHub Actions 作业上运行每个浏览器，以便在所有浏览器中高效测试您的应用程序。

// e2e-test-automation.yml
    jobs:
      chrome:
        timeout-minutes: 30
        runs-on: ubuntu-latest
        container:
          image: mcr.microsoft.com/playwright:v1.38.1-jammy
    
        steps:
          - uses: actions/checkout@v4
          - uses: actions/setup-node@v3
            with:
              node-version: 'latest'
    
          - name: Install dependencies
            run: npm ci
    
          - name: Run Google Chrome tests
            run: npm run test:chrome
            env:
              BASE_URL: ${
       { vars.BASE_URL }}
              HEADLESS: ${
       { vars.HEADLESS }}
              OUTPUT_PATH: output-chrome
    
          - uses: actions/upload-artifact@v3
            if: always()
            with:
              name: chrome-artifacts
              path: output-chrome
              retention-days: 30
    
      firefox:
        ...
    
      safari:
        ...

### **修复Firefox在GitHub Actions上运行的问题** ###

对于 Firefox，在 Github Actions 中运行 Playwright 自动化失败，并显示错误消息：**不支持在常规用户会话中以 root 身份运行 Nightly**。

![图片][77930722b17da54a183136430a1d6633.png]

不支持在常规用户会话中以 root 身份每晚运行的GitHub Actions 日志错误

要解决此问题，我们需要通过`HOME`在流水线中添加环境变量来解决该问题。

// e2e-test-automation.yml
    - name: Run Firefox scenarios
      run: npm run test:firefox
      env:
        BASE_URL: ${
       { vars.BASE_URL }}
        HEADLESS: ${
       { vars.HEADLESS }}
        OUTPUT_PATH: output-firefox
    ->  HOME: /root

### **完整的GitHub Actions流水线** ###

// e2e-test-automation.yml
    name: E2E Test Automation
    
    on: [ push ]
    
    jobs:
      chrome:
        timeout-minutes: 30
        runs-on: ubuntu-latest
        container:
          image: mcr.microsoft.com/playwright:v1.38.1-jammy
    
        steps:
          - uses: actions/checkout@v4
          - uses: actions/setup-node@v3
            with:
              node-version: 'latest'
    
          - name: Install dependencies
            run: npm ci
    
          - name: Run Chrome scenarios
            run: npm run test:chrome
            env:
              BASE_URL: ${
       { vars.BASE_URL }}
              HEADLESS: ${
       { vars.HEADLESS }}
              OUTPUT_PATH: output-chrome
    
          - uses: actions/upload-artifact@v3
            if: always()
            with:
              name: chrome-artifacts
              path: output-chrome
              retention-days: 30
    
      firefox:
        timeout-minutes: 30
        runs-on: ubuntu-latest
        container:
          image: mcr.microsoft.com/playwright:v1.38.1-jammy
    
        steps:
          - uses: actions/checkout@v4
          - uses: actions/setup-node@v3
            with:
              node-version: 'latest'
    
          - name: Install dependencies
            run: npm ci
    
          - name: Run Firefox scenarios
            run: npm run test:firefox
            env:
              BASE_URL: ${
       { vars.BASE_URL }}
              HEADLESS: ${
       { vars.HEADLESS }}
              OUTPUT_PATH: output-firefox
              # Workaround to fix GitHub Actions issue:
              # Running Nightly as root in a regular user's session is not supported.
              # See https://github.com/microsoft/playwright/issues/6500
              HOME: /root
    
          - uses: actions/upload-artifact@v3
            if: always()
            with:
              name: firefox-artifacts
              path: output-firefox
              retention-days: 30
    
      safari:
        timeout-minutes: 30
        runs-on: ubuntu-latest
        container:
          image: mcr.microsoft.com/playwright:v1.38.1-jammy
    
        steps:
          - uses: actions/checkout@v4
          - uses: actions/setup-node@v3
            with:
              node-version: 'latest'
    
          - name: Install dependencies
            run: npm ci
    
          - name: Run Safari scenarios
            run: npm run test:safari
            env:
              BASE_URL: ${
       { vars.BASE_URL }}
              HEADLESS: ${
       { vars.HEADLESS }}
              OUTPUT_PATH: output-safari
    
          - uses: actions/upload-artifact@v3
            if: always()
            with:
              name: safari-artifacts
              path: output-safari
              retention-days: 30

### **总结** ###

使用CodeceptJS、Playwright和GitHub Actions构建端到端测试流水线为自动化测试场景提供了强大的解决方案。通过利用 CodeceptJS 和 Playwright 的功能，可以轻松地跨不同浏览器和环境进行自动化测试。GitHub Actions 允许在 GitHub 存储库中无缝集成和自动化测试流程。

本文中概述的配置和设置，希望给大家提供参考。

**相关地址：**

https://github.com/microsoft/playwright/issues/6500

https://github.com/bear-plus/codeceptjs-playwright-typescript-boilerplate

https://github.com/bear-plus

行动吧，在路上总比一直观望的要好，未来的你肯定会感谢现在拼搏的自己！如果想学习提升找不到资料，没人答疑解惑时，**请及时加入群： 786229024**，里面有各种测试开发资料和技术可以一起交流哦。

**最后：** 下方这份完整的软件测试视频教程已经整理上传完成，需要的朋友们可以自行领取**`【保证100%免费】`**

![在这里插入图片描述][8947696fd59240c4a13e89c0b57c7959.png_pic_center]

#### 软件测试面试文档 ####

我们学习必然是为了找到高薪的工作，下面这些面试题是来自阿里、腾讯、字节等一线互联网大厂最新的面试资料，并且有字节大佬给出了权威的解答，刷完这一套面试资料相信大家都能找到满意的工作。

![在这里插入图片描述][c412916cdf6c49e58f8ed80f619361dd.png_pic_center]

![在这里插入图片描述][e69c203821d74ff38ffdbe1f827dbb1c.png]

![在这里插入图片描述][755123cb1321421b96888db976754489.png]

![79ea5ca9ad3e4727b128d34e1560c816.gif][]

[2b3de9ea6bff450696d634f9281ae061.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/e77de474d9eb4563b5f6ff05c21af2fc.png
[651f90c533df0a6f71c4f6054e0046f2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/430da28361a3447ab5a9ec84a32a9507.png
[2ce0eec5bb89b04364d0b21bdb472c20.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/94eb5a52b8b846ac9c493f07ef356aaa.png
[77930722b17da54a183136430a1d6633.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/8808487073bb448db6b266e4245298aa.png
[8947696fd59240c4a13e89c0b57c7959.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/21ee94c1360e4152a341f00976ccc2c5.png
[c412916cdf6c49e58f8ed80f619361dd.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/92a0404bfb414a0d8ce655159c6d4fc5.png
[e69c203821d74ff38ffdbe1f827dbb1c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/676bd4fc77eb492f8d226a5952188e43.png
[755123cb1321421b96888db976754489.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/df3e50e3f8d14b0bb90638cbc3d9addf.png
[79ea5ca9ad3e4727b128d34e1560c816.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/20/030eeace673f4f7c99586feea1523015.png