使用说明
🎭 剧作家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结果
✅ 初学者指南 -逐步记录
🎓 学习资源
- 📖 剧作家文档 -正式文件
- 💡 剧作家督察 -交互式元素选择器
- 🎬 剧作家教程 -视频指南
- 💬 GitHub Copilot -编码时的AI帮助
🤖 高级功能(可选)
在MCP中使用GitHub复制代理模式
使用AI自动生成测试!
从这里开始: MCP_AND_CLI_COMPLETE_GUIDE.md ← 完成工作流程!
或者跳到特定的指南:
- 播放版权_MCP_GUIDE.md -如何使用MCP
- 播放版权_点击_ GIDE.md -所有CLI命令
- 自动测试_ CENARIO.md -3个真实例子
- MCP_CLI_QUICK_REFERENCE.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 你的第一次测试! 🎉