Skip to main content

設定 CI

簡介

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

你將學到

設定 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 儲存庫,這樣你就可以 addcommitpush 你的程式碼。

建立一個 Repo 並推送到 GitHub

開啟工作流程

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

開啟工作流程

檢視測試日誌

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

查看測試日誌

檢視追蹤

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

playwright trace viewer

接下來是什麼