设置 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
中的步骤列表,你可以看到工作流程执行以下步骤:
- 克隆你的仓库
- 安装语言依赖
- 安装项目依赖并构建
- 安装 Playwright 浏览器
- 运行测试
创建仓库并推送到 GitHub
一旦你设置了 GitHub actions 工作流程,你需要做的就是 在 GitHub 上创建一个仓库 或将你的代码推送到现有仓库。按照 GitHub 上的说明操作,不要忘记使用 git init
命令 初始化 git 仓库,以便你可以 添加、提交 和 推送 你的代码。
打开工作流程
点击 Actions 标签以查看工作流程。在这里你可以看到你的测试是否通过或失败。
查看测试日志
点击工作流程运行将显示 GitHub 执行的所有操作,点击 Run Playwright tests 将显示错误信息、预期结果以及实际收到的内容,还有调用日志。
查看追踪
trace.playwright.dev 是追踪查看器的一个静态托管版本。你可以通过拖放上传追踪文件。