# 基于java实现playwright的UI自动化框架

**Repository Path**: rebortgzmyinit/vss_playwright_ui_java

## Basic Information

- **Project Name**: 基于java实现playwright的UI自动化框架
- **Description**: 基于java+maven+playwright+testNG+allure+jenkins实现的UI自动化测试框架，采用PO模式进行设计
日志&测试步骤
报告&失败截图
配置文件&数据源设计
公共函数&API封装
测试数据&参数化、解耦
测试套件&测试用例设计、组装
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-28
- **Last Updated**: 2025-12-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: playwright

## README

# VSS Playwright UI 自动化测试项目

## 项目简介
本项目是基于 Playwright 和 TestNG 的 Web UI 自动化测试框架，用于测试 VSS 系统的登录功能。项目采用 Page Object 模式，提高测试代码的可维护性和可读性。

## 主要功能
- 实现对 VSS 系统管理员用户的登录功能测试
- 提供浏览器初始化和配置管理
- 支持失败自动截图并集成 Allure 报告
- 支持测试重试机制，提高测试稳定性

## 技术栈
- Java
- Playwright
- TestNG
- Allure

## 项目结构
- `src/test/java/com/howen/PageObject/` - 页面对象类，如 `LoginPage`
- `src/test/java/com/howen/framework/` - 框架基础类，如浏览器引擎、日志工具等
- `src/test/java/com/howen/listener/` - 测试监听器，如截图、重试机制
- `src/test/java/com/howen/testcase/` - 测试用例类，如 `TestLogin`
- `src/test/resources/` - 配置文件目录，包含 `config.properties` 和 `allure.properties`
- `testng.xml` - TestNG 测试配置文件
- `pom.xml` - Maven 项目配置文件

## 环境依赖
- Java 17 或更高版本
- Maven
- Playwright 浏览器环境

## 安装步骤
1. 安装 Java 并配置环境变量
2. 安装 Maven
3. 安装 Playwright 并配置浏览器环境
4. 克隆项目到本地
5. 执行 Maven 构建命令

## 使用说明
1. 配置 `src/test/resources/config.properties` 中的测试参数
2. 编写或修改测试用例
3. 执行测试：
   ```bash
   mvn test
   ```
4. 查看测试报告：
   ```bash
   allure serve target/allure-results
   ```

## 测试执行
- 使用 TestNG 执行测试用例
- 测试结果会自动生成 Allure 报告
- 测试失败时会自动截图并保存到报告中

## 日志记录
- 测试过程中会生成日志文件，日志文件名可在 `Logger.java` 中配置
- 日志类型定义在 `LogType.java` 中

## 测试监听
- `TestResultListener` 负责监听测试结果并实现失败截图功能
- `RetryListener` 提供测试失败重试机制
- `GlobalAnnotationTransformer` 支持全局测试配置

## 许可证
本项目遵循 MIT 许可证，请参见 [LICENSE](LICENSE) 文件。