A simplified Playwright wrapper with multi-tab support, element highlighting, and smart waiting
Project description
Playwright-EZ 🎭
一个功能全面、简单易用的 Playwright 封装库，让浏览器自动化变得简单高效。
✨ 核心特性
🗂️ 多标签页管理
创建、切换、关闭标签页，并行/顺序执行操作
🎨 元素高亮
操作元素时自动高亮显示，方便调试
⏳ 智能等待
13种等待条件，自定义条件，带重试执行
🔍 智能选择器
CSS/XPath/Text/Role/Placeholder/Label/链式选择器
🍪 Cookie & Session管理
保存/加载Cookie，会话状态管理
🌐 网络监控 & 拦截
请求日志、API追踪、拦截、模拟响应
📁 文件操作
上传/下载文件、批量上传、PDF转换
🛡️ 反检测
隐藏自动化特征、人类化操作
📝 表单处理
智能填充、验证、登录表单快捷操作
🏗️ 页面对象模型(POM)
BasePage、PageFactory、步骤装饰器
📊 性能分析
页面加载指标、Web Vitals、资源分析
📱 移动端模拟
20+预定义设备、GPS定位、网络条件模拟
👁️ 视觉测试
截图对比、差异检测、报告生成
🎬 操作录制回放
录制操作、回放、代码自动生成
🐛 调试工具
调试信息捕获、错误处理、断言库
📤 数据提取
表格/列表提取、JSON-LD、结构化数据
🔌 API测试
HTTP请求、Mock服务、GraphQL支持
🔗 WebSocket监控
WS连接监控、消息拦截、录制回放
🧪 Pytest集成
Fixtures、Hooks、测试报告
💻 命令行工具
截图、录制、回放、抓取命令
🔐 验证码处理
验证码识别辅助、滑动验证码处理
🎲 数据生成
测试数据生成器，支持多种数据类型
📈 测试报告
HTML报告、性能报告、覆盖率报告
💾 数据库操作
SQLite数据库简化操作
⚙️ 环境管理
多环境配置、密钥管理
📦 安装
pip install playwright-ez
playwright install chromium
🚀 快速开始
import asyncio
from playwright_ez import EasyBrowser
async def main():
async with EasyBrowser() as browser:
# 导航
await browser.goto("https://example.com")
# 操作（自动高亮+智能等待）
await browser.click("button.submit")
await browser.type_text("input.email", "test@example.com")
# 获取内容
text = await browser.get_text("h1")
print(text)
asyncio.run(main())
📚 文档
详细文档请参考项目源码中的docstring。
📄 License
MIT
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file playwright_ez-2.5.0.tar.gz.
File metadata
- Download URL: playwright_ez-2.5.0.tar.gz
- Upload date:
- Size: 298.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a69d67b590337f44a9196873274bcf6a6c4567ebcdc628402516c67fdd8476a0
|
|
| MD5 |
205b8c919ba78ad24e8118fcd6edabbd
|
|
| BLAKE2b-256 |
ecbd447cfd2013f4180ab78d8f5fc88fce4d60db09e9e1b13403114bf559ef24
|
File details
Details for the file playwright_ez-2.5.0-py3-none-any.whl.
File metadata
- Download URL: playwright_ez-2.5.0-py3-none-any.whl
- Upload date:
- Size: 353.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
75cd51f8e6436cf83a66cbf8457a1c54341cb225d61b1bb6be9f13fb8dc6ca24
|
|
| MD5 |
ac84d5f158505051286f1567c75efba3
|
|
| BLAKE2b-256 |
76995f5ec0c931bef2a4926e625024323441bab5afd1704cddba9e8e4ba2dbb3
|
