設定 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: Setup dotnet
      uses: actions/setup-dotnet@v4
      with:
        dotnet-version: 8.0.x
    - name: Build & Install
      run: dotnet build
    - name: Ensure browsers are installed
      run: pwsh bin/Debug/net8.0/playwright.ps1 install --with-deps
    - name: Run your tests
      run: dotnet test

要了解更多資訊，請參閱"了解 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 頁籤以查看工作流程。在這裡你將看到你的測試是否通過或失敗。

在 Pull Requests 中，你也可以點擊 PR status check 中的 Details 連結。

檢視測試日誌

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

檢視追蹤

您可以上傳在您的 CI（如 GitHub Actions）上建立的 Traces 作為 artifacts。這需要開始和停止 trace。我們建議僅記錄失敗測試的 traces。一旦您的 traces 已上傳到 CI，它們可以使用 trace.playwright.dev 下載並打開，這是一個靜態託管的 Trace Viewer 變體。您可以使用拖放上傳 trace 文件。

接下來是什麼

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