Playwright 测试框架

本项目包含 Zeigo Network Dashboard 的 UI 和 API 测试，使用 Playwright 进行端到端 (E2E) 测试。

我们使用的技术

Playwright 为现代 Web 应用程序提供可靠的端到端测试，具有以下功能：

• 跨浏览器测试支持
• 跨平台测试能力
• 多语言支持（TypeScript、JavaScript、Python、.NET、Java）
• 移动 Web 测试
• 并行测试执行
• 内置调试工具

文档

• Playwright 官方文档
• 运行测试指南

结构

• .vscode/: 工作区特定设置。
• ui-tests/specs/: UI 测试规范。
• api-tests/specs/: API 测试规范。
• pages/: 页面对象模型 (POM) 文件。
• utils/: 实用函数或助手。
• .env: 环境变量。
• .gitignore: 从版本控制中排除的文件。

前提条件

1. Node.js: 安装 Node.js v20 或更高版本

2. 环境设置: 创建一个 .env 文件，包含以下配置：

   # 基础 URL
   API_BASE_URL=https://your-api-url
   UI_BASE_URL=https://your-ui-url
   

快速开始

1. 安装 Playwright 和依赖项：

   npm install
   npx playwright install
   npm install dotenv
   

2. 安装 VS Code Playwright 扩展：

   code --install-extension ms-playwright.playwright
   

3. 运行测试：

测试执行选项

使用 VS Code 测试资源管理器

• 打开 VS Code
• 点击活动栏中的测试图标（烧杯图标）
• 点击播放按钮以运行所有测试
• 或者点击每个测试旁边的播放按钮来运行单个测试

使用命令行

基本测试命令

# 运行所有测试
npx playwright test

# 在有头模式下运行测试
npx playwright test --headed

# 在特定浏览器中运行测试
npx playwright test --project=chromium

# 调试模式
npx playwright test --debug

# 使用 Codegen 生成测试
npx playwright codegen

环境特定测试执行

Windows PowerShell

# 测试环境
$env:CI="true"; $env:target_env="test"; npx playwright test --reporter=list

# PreProd 环境
$env:CI="true"; $env:target_env="preprod"; npx playwright test --reporter=list

macOS/Linux

# 测试环境
CI=1 target_env="test" npx playwright test --reporter=list

# PreProd 环境
CI=1 target_env="preprod" npx playwright test --reporter=list

运行特定测试

# 按测试名称运行
npx playwright test -g "name of my test" --project=chromium

# 运行特定测试文件
npx playwright test tests/specific-test.spec.js

# 运行带有特定标签的测试
npx playwright test --grep @tag_name

浏览器特定测试执行

# Chrome
npm run regression:chromium

# Safari
npm run regression:safari

# 所有浏览器在无头模式下
npm run regression

# 所有浏览器在有头模式下
npm run regression:headed

测试调度器

要以批处理方式运行测试并设置延迟：

.\run_tests_scheduler.bat

测试资源管理器功能

• 🔍 在树状视图中浏览测试
• ▶️ 运行/调试单个测试或测试文件
• 🔄 重新运行失败的测试
• 📊 内联查看测试结果
• 🎯 跳转到测试定义
• 📋 按状态或标签过滤测试
• 🎯 使用断点调试测试