設定 CI

簡介

Playwright 測試可以在任意 CI 提供者上執行。在本節中，我們將介紹如何使用 GitHub Actions 在 GitHub 上執行測試。如果您想了解如何配置其他 CI 提供者，請查看我們關於持續整合的詳細文件。

你將學到

• 如何設定 GitHub Actions
• 如何查看測試日誌
• 如何查看追蹤

設定 GitHub Actions

要新增 GitHub Actions 文件，首先建立 .github/workflows 資料夾，並在其中新增一個 playwright.yml 文件，包含以下範例程式碼，以便您的測試在每次推送和針對 main/master 分支的拉取請求時執行。

.github/workflows/playwright.yml

name: Playwright Tests
on:
  push:
    branches: [ main, master ]
  pull_request:
    branches: [ main, master ]
jobs:
  test:
    timeout-minutes: 60
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v4
    - name: Set up Python
      uses: actions/setup-python@v4
      with:
        python-version: '3.11'
    - name: Install dependencies
      run: |
        python -m pip install --upgrade pip
        pip install -r requirements.txt
    - name: Ensure browsers are installed
      run: python -m playwright install --with-deps
    - name: Run your tests
      run: pytest --tracing=retain-on-failure
    - uses: actions/upload-artifact@v4
      if: ${{ !cancelled() }}
      with:
        name: playwright-traces
        path: test-results/

要了解更多資訊，請參閱"了解 GitHub Actions"。

查看 jobs.test.steps 中的步驟列表，你可以看到工作流程執行了這些步驟:

1. 複製你的儲存庫 2. 安裝語言相依套件 3. 安裝專案相依套件並建構 4. 安裝 Playwright 瀏覽器 5. 執行測試

建立一個 Repo 並推送到 GitHub

一旦你設定好你的 GitHub actions workflow 後，你所需要做的就是 在 GitHub 上建立一個 repo 或將你的程式碼推送到現有的儲存庫。按照 GitHub 上的指示操作，並且不要忘記使用 git init 命令 初始化一個 git 儲存庫，這樣你就可以 add、commit 和 push 你的程式碼。

開啟工作流程

點擊 Actions 頁籤以查看工作流程。在這裡你將看到你的測試是否通過或失敗。

檢視測試日誌

點擊工作流程執行將顯示 GitHub 執行的所有操作，點擊 Run Playwright tests 將顯示錯誤訊息、預期結果和實際接收到的結果以及呼叫日誌。

檢視追蹤

trace.playwright.dev 是 Trace Viewer 的靜態託管變體。你可以使用拖放上傳 trace 檔案。

接下來是什麼

• 學習如何使用 Locators
• 學習如何執行 Actions
• 學習如何撰寫 Assertions
• 了解更多關於 Trace Viewer
• 了解更多在 GitHub Actions 上執行測試的方法
• 了解更多在其他 CI 提供者上執行測試 // TODO: is this link correct?