浏览器自动化测试工具

PlaywrightMCP是一个基于Playwright的浏览器自动化测试工具,提供简单易用的测试脚本编写和报告生成功能,适用于Web应用的登录测试、表单验证和电商流程等场景。

  • by Udaykumaryellaboina
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Udaykumaryellaboina/PLaywrightMCP

使用说明

🎭 剧作家MCP-让Web测试变得简单

欢迎 此项目可帮助您使用Playwright自动化web测试。


🎯 选择你的道路

你想要什么 来这里
视觉学习者?看地图! 👉 文件_MAP.md 🗺️
全新?不确定从哪里开始? 👉 GETTING_STARTED.md ✅
快速查找文档 👉 INDEX.md -所有文档目录
只需复制和粘贴命令 👉 QUICKSTART.txt
完整的初学者指南 👉 开始.md
了解项目 👉 项目_基础.md
什么东西坏了? 👉 故障排除.md

🚀 30秒设置

# 1. Install
npm install && npx playwright install chromium

# 2. Copy settings
copy .env.example .env

# 3. Run your first test!
npx playwright test tests/TC_BEGINNER_00_simple_first_test.spec.ts --project=chromium

就是这样!你刚刚完成了你的第一次剧作家测试! ✅


📊 查看结果

npm run report

打开一个漂亮的HTML报告,显示通过和失败的内容。


🎯 什么是剧作家?

Playwright实现了网络浏览器的自动化。你编写的代码是:

  • 打开网站
  • 点击按钮
  • 键入文本
  • 验证内容

计算机在您的测试中只点击一次,而不是手动点击100次!非常适合:

  • ✅ 登录测试
  • ✅ 表单验证
  • ✅ 电子商务结账流程
  • ✅ 任何重复的网络任务

📚 范例学习

该项目包括易于遵循的测试示例:

测试文件 它的作用 难度
TC_BEGINNER_00_simple_first_test.spec.ts 谷歌搜索 ⭐ 最简单
TC_BEGINNER_01_login_commended.spec.ts 登录并提供完整说明 ⭐⭐ 简单
TC_P001_login_happy_path.spec.ts 专业登录测试 ⭐⭐⭐ 中等
SearchActiveOrders.spec.ts 数据库驱动测试 ⭐⭐⭐⭐ 高级

从最简单的开始,一步步向上!


🛠️ 常用命令

# Install once
npm install
npx playwright install chromium

# Run tests
npm test                                    # All tests
npx playwright test tests/FILENAME.spec.ts # One test
npm run report                              # View results

# Find elements interactively
npx playwright codegen https://example.com

📁 项目结构

tests/                      ← Tests you write go here
  TC_BEGINNER_00_*.spec.ts ← Start with these!
  TC_BEGINNER_01_*.spec.ts
  TC_P001_*.spec.ts        ← Real examples
  
.env.example               ← Safe template
.env                       ← Your settings (don't share!)
playwright.config.ts       ← Test configuration
package.json              ← Project settings

❓ 帮助与支持

|需要帮助。首选 |------------------|----------| | 快速设置 | 开始.md | | 了解文件 | 项目_基础.md | | 错误或问题 | 故障排除.md | | 剧作家详细信息 | https://playwright.dev |


💾 项目特点

✅ 简单易用 -5分钟后开始
✅ 好评如潮 -易于理解的示例
✅ 实际测试 -基于实际网站
✅ 多种测试类型 -从简单到高级
✅ 出色的报告 -漂亮的HTML结果
✅ 初学者指南 -逐步记录


🎓 学习资源


🤖 高级功能(可选)

在MCP中使用GitHub复制代理模式

使用AI自动生成测试!

从这里开始: MCP_AND_CLI_COMPLETE_GUIDE.md ← 完成工作流程!

或者跳到特定的指南:

快速示例:

@playwright Open https://www.saucedemo.com and log in
@playwright Generate a test for the products page

然后使用CLI运行:

npx playwright test --headed --slow-mo=1000
npx playwright show-report

📋 测试场景

本项目包括以下测试:

  • ✅ 有效登录(快乐路径)
  • ❌ 无效登录(错误案例)
  • 🔄 数据库驱动的E2E流
  • 🌐 多语言UI测试

🔒 安全

  • ✅ 证书在 .env (从未承诺)
  • ✅ 默认情况下使用的公共演示网站
  • ✅ 代码或报告中没有秘密
  • ✅ 共享存储库是安全的(除 .env)

📄 许可证

MIT-免费使用和修改。


从开始 开始.md 你的第一次测试! 🎉