用途：编写原生 Python Playwright 脚本，对本地 Web 应用做端到端测试、UI 自动化与交互测试、视觉回归测试、浏览器日志捕获与调试、表单提交与校验验证。不适用于无浏览器的纯 API 测试、单函数单元测试、移动应用测试以及负载性能测试。
主要能力：无头浏览器启动、页面导航、网络空闲等待、角色/文本/test-id/CSS 多种选择器、截图（整页与元素）、控制台消息捕获、表单填写与提交、断言（文本、可见性、启用状态、URL、标题）、弹窗与多标签处理。
使用方式：先判断页面是否静态；静态可直接读 HTML 获取选择器，动态应用需先确认服务已启动，再采用“侦察后操作”：导航并等待 networkidle、截图或检查 DOM、从渲染状态确定选择器、再执行操作。核心结构： from playwright.sync_api import sync_playwright with sync_playwright() as p: browser = p.chromium.launch(headless=True) page = browser.new_page() page.goto('http://localhost:5173') page.wait_for_load_state('networkidle') browser.close() 运行可用 python -m pytest tests/test_login.py、PWDEBUG=1 python -m pytest tests/test_login.py、python -m pytest --tracing=on tests/test_login.py。
适用场景：本地 Web 前端功能验证、UI 行为调试、截图取证、表单流程测试。
限制与注意：避免不等待网络空闲、硬编码 time.sleep、渲染前检查 DOM 等反模式；选择器应优先角色、文本、test-id，CSS 为最后手段；测试应保持独立并在失败时截图。资料未提供收费、价格与平台等细节。