playwright截图更稳是因为其原生自动等待页面加载、资源就绪和网络空闲，无需手动sleep或复杂等待；支持多浏览器及自动处理滚动、高dpi、暗色模式等细节，而selenium需自行hack补全。
Playwright截图为什么比Selenium更稳？
因为Playwright默认等待页面加载完成、资源就绪、网络空闲，而截图前不用手动加time.sleep()或复杂等待逻辑。它原生支持多浏览器（Chromium/Firefox/WebKit），且截图时自动处理滚动、高DPI缩放、暗色模式等细节——这些在Selenium里常要自己补hack。
实操建议：
- 用
page.screenshot()而非browser.screenshot()，后者不存在；截图必须在page实例上调用 - 关键参数：
full_page=True截整个网页（含滚动区域），type="png"或"jpeg"，quality=80仅对jpeg生效 - 若截图空白或只截到顶部，大概率是页面还没渲染完——改用
page.wait_for_load_state("networkidle")代替page.wait_for_timeout(2000) - Linux服务器无GUI时，必须启动浏览器带
headless=True（Playwright 1.40+默认启用），否则报错BrowserType.launch: Executable doesn't exist
如何让Playwright截图准确捕获动态内容？
比如React/Vue组件异步加载数据、懒加载图片、动画结束后的DOM状态——直接截图会截到骨架屏或loading占位符。
实操建议：
- 别依赖“页面加载完成”就截图，改用
page.wait_for_selector("text=提交成功", state="visible")等精准等待目标元素出现 - 对JS动态渲染的区域，可用
page.evaluate()确认状态：page.evaluate("() => window.myApp?.isReady === true") - 截图前加
page.wait_for_timeout(100)（仅100ms）防微小渲染延迟，比sleep(2000)更合理 - 避免用
page.content()后转成截图——这截的是HTML字符串快照，不是真实渲染结果
Playwright自动化测试中怎么断言截图差异？
Playwright本身不提供图像比对，但可结合expect(page).to_have_screenshot()做基准比对，底层调用pixelmatch。
实操建议：
- 首次运行测试时加
--update-snapshots生成基准图（存于__snapshots__目录），后续运行才触发比对 - 敏感区域（如时间戳、用户头像）用
mask参数遮盖：page.screenshot(mask=[page.locator(".timestamp")]) - 跨浏览器测试时，不同引擎渲染字体/间距有微小差异，建议设
threshold=0.2（默认0.05）放宽容差 - CI环境字体缺失会导致截图失败，需预装字体包（Ubuntu：安装
fonts-liberation和ttf-ubuntu-font-family）
为什么playwright test命令跑截图测试总超时？
常见原因是测试用例里混用了同步阻塞操作（如print()大量日志、未await的Promise、或错误地用了page.click()没加await），导致事件循环卡住，截图超时被中断。
实操建议：
- 所有Playwright API调用必须
await，包括page.goto()、page.screenshot()、page.locator().click() - 禁用控制台输出干扰：
playwright test --quiet，或重定向日志到文件 - 截图路径必须是相对路径（如
"./screenshots/home.png"），绝对路径在CI里容易因工作目录不同而写入失败 - 若用
pytest-playwright插件，确保playwright版本与插件兼容（当前稳定配对是v1.42+ + pytest-playwright 0.6.0+）
截图不是“点一下就完事”的操作，它的稳定性取决于你对页面生命周期的理解程度——比如什么时候该等元素，什么时候该等网络，什么时候该忽略渲染抖动。这些判断没法靠工具自动完成，得从错误截图里反推页面当时的真实状态。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
