Playwright 中 page.screenshot() 默认不支持长截图，需显式传入 full_page=True 参数才能截取完整可滚动页面；该参数启用后由 Playwright 自动滚动并合成全页图像，否则仅截当前视口。
Playwright 中 page.screenshot() 默认不支持长截图怎么办
Playwright 原生的 page.screenshot() 默认只截当前视口（viewport），不会滚动拼接——这和 Puppeteer 的 fullPage: true 行为不同，也不同于 Selenium 的手动滚动截图逻辑。想截整个页面（比如长文章、报表、聊天记录流），必须显式启用全页模式。
正确做法是传入 full_page=True 参数：
page.screenshot(path="full.png", full_page=True)
注意：这不是可选开关，而是强制行为；若省略或设为 False，哪怕页面已滚动到底部，也只截当前可视区域。
-
full_page=True会自动计算页面总高度，逐段滚动并合成图像，无需手动控制scrollTo - 不支持指定「从某元素开始截到页面底部」这类局部长截图，只能是整页或指定区域
- 合成过程由 Playwright 内部管理，比手写滚动+截图+拼接更稳定，尤其对 sticky/fixed 元素兼容更好
截取特定元素（如 div#content）的完整内容，而非整页
Playwright 没有内置的「元素级长截图」API，element.screenshot() 同样只截该元素在当前视口内的可见部分。要截一个可能溢出容器、需滚动才能看全的元素（例如带 overflow-y: auto 的 <div>），得先让该元素进入视口并展开其全部内容。
立即学习“Python免费学习笔记（深入）”；
实操分两步：
- 用
element.scroll_into_view_if_needed()确保元素顶部对齐视口顶部 - 用
page.evaluate()获取元素真实滚动高度，并临时修改其样式（如设overflow: visible、height: "auto"），再调用element.screenshot()
示例（截取 div.report 的全部内容）：
report = page.query_selector("div.report")
report.scroll_into_view_if_needed()
page.evaluate("""(el) => {
el.style.overflow = 'visible';
el.style.height = 'auto';
}""", report)
report.screenshot(path="report-full.png")
⚠️ 注意：修改样式后记得恢复（尤其在循环处理多个元素时），否则后续截图可能错位；若元素含阴影、border-radius 或 transform，合成图像边缘可能出现裁剪异常。
生成高清长图时，scale 和 quality 参数怎么设才不糊
长截图本身像素量大，若再叠加高缩放因子，极易触发内存溢出或超时。Playwright 的 screenshot() 支持 scale="css"（默认）、"device"，但实际影响清晰度的关键是 quality（仅对 JPEG 有效）和底层渲染分辨率。
- 优先用
type="png"（默认），避免 JPEG 压缩失真；PNG 不受quality影响 - 如必须用 JPEG，
quality=95是实用上限，再高体积陡增但肉眼无差别 -
scale="device"会按设备像素比（dpr）放大，比如 dpr=2 时输出宽高翻倍——长图下慎用，易 OOM - 真正提升文字/线条锐度的方式是确保页面未被缩放（检查
page.emulate_media(media="screen")是否干扰了 CSS @media 查询）
截图失败常见报错及绕过方法
长截图比普通截图更易失败，典型错误包括：
-
TimeoutError: Timeout 30000ms exceeded：页面动态内容未加载完就截图。加page.wait_for_load_state("networkidle")或监听关键元素page.wait_for_selector(".final-content", state="visible") -
Error: Element is not attached to the DOM：截图前元素已被移除或重绘。改用page.locator()+first().screenshot()替代query_selector()，locator 具备自动重试能力 - 空白图或截到一半：某些前端框架（如 Vue/React）在滚动过程中卸载组件。可在截图前执行
page.evaluate("window.scrollTo(0, 0)")回顶，再等 100ms 让 UI 稳定
长截图的稳定性高度依赖目标页面的渲染节奏，没有银弹；与其反复调参，不如用 page.pdf() 作为备选——它天生支持整页导出，且对文本/矢量内容更友好，只是不支持截图里的鼠标指针、高亮色块等光栅化效果。
