应选wait_until="commit"：它等待浏览器完成导航并提交首个渲染帧，比"load"更早、比"networkidle"更准；对iframe、Canvas等需分层等待其各自就绪状态，而非统一延时。
wait_until 参数选错导致 DOM 渲染未就绪
很多人用 page.goto(url) 后直接截图，发现按钮、列表或动态图表区域是空的——这不是网络慢，而是 Playwright 默认只等 HTML 解析完，不等 JS 渲染。比如页面靠 fetch 加载商品列表，初始 HTML 里根本没数据。
实操建议：
-
wait_until="commit"是最稳妥的选择：它等浏览器完成导航并提交首个渲染帧，比"load"更早、比"networkidle"更准，适合绝大多数 SPA - 避免用
"networkidle0"：它依赖“无网络请求”信号，但有些站点会轮询心跳或埋点，永远达不到 idle 状态 - 若页面有明确加载指示器（如
div.loading），优先用page.wait_for_selector("div.loading", state="hidden")，比猜等待时间更可靠
截图前没等 iframe 或动态模块挂载
含 iframe 的弹窗、广告位、嵌入式看板，其内容不在主页面 DOM 树里。直接对 page 调用 screenshot() 或 locator()，必然漏掉这些区域。
实操建议：
- 用
page.frame_locator('iframe[src*="report"]')定位，再链式调用.locator('canvas#chart').wait_for(state='visible')，别先取content_frame() - 懒加载
iframe（带loading="lazy"）需先滚动到视口：await iframe_locator.scroll_into_view_if_needed() - 不要遍历
page.frames手动匹配 URL：异步时机难控，容易拿到旧 frame 或空 frame
element.screenshot() 截的是“当前可见部分”，不是完整内容
对一个 overflow-y: auto 的 div 调用 element.screenshot()，只会截它此刻在视口内显示的那一小段——哪怕里面实际有 100 行日志，也只截出顶部 5 行。
实操建议：
- 要截完整元素，得先让内容全部展开：比如点击“展开全部”按钮，或执行
element.evaluate("el => el.scrollTo(0, el.scrollHeight)") - Playwright 没有原生“元素级长截图”，
full_page=True只作用于整页；若只需某区块，得结合clip参数手动计算范围 - 用
element.bounding_box()前务必确认元素已 layout 完成，否则返回None；可加page.wait_for_function("() => document.querySelector('#log-box').offsetHeight > 0")
局部黑屏常被误判为“没加载”，其实是 WebGL/Canvas 未就绪
地图、ECharts、Three.js 图表区域截图全黑，但文字和按钮正常——这大概率不是 JS 没跑完，而是 Canvas 渲染上下文还没初始化完毕，或者 WebGL 在无头模式下被禁用。
实操建议：
- 对 Canvas 元素，别等
is_visible()，改用page.wait_for_function("() => document.querySelector('canvas').width > 0") - 启动浏览器时加参数：
chromium.launch(args=["--use-gl=swiftshader"])强制启用软件渲染 - 局部黑屏几乎从不因超时引起，加
time.sleep()无效；必须等 Canvas 自身 ready 状态，而非父容器可见
真正卡住人的，往往不是“等多久”，而是“等什么”。DOM 就绪、JS 执行、Canvas 初始化、iframe 挂载、滚动定位——它们是不同层的就绪信号，混用就会漏内容。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
