用途:对任意 URL 进行整页(full-page)截图,基于 Playwright 实现,面向自动化网站监控、视觉回归测试、网页归档、文档生成与质量保证等场景。
主要能力:视口 1920x1080,设备缩放因子 0.5(实际渲染约 960x540);整页截图;超时错误处理;截图前重载页面以提升稳定性;截图数据 Base64 编码;超时时间 120 秒,适配加载较慢的页面。
使用方式:Python 依赖安装为 pip install playwright 与 playwright install chromium。核心函数 get_screenshot(url) 启动 Chromium,以 wait_until="domcontentloaded" 打开页面,超时则捕获 TimeoutError 并等待 2 秒,随后重载页面并调用 page.screenshot(path="screenshot.png", full_page=True),最后读取 PNG 并 Base64 编码返回。可自定义输出路径、批量处理多个 URL,或改用 load、networkidle 等待策略。
等待策略:domcontentloaded 为默认,速度快,适合多数页面;load 等待全部资源,更可靠但更慢;networkidle 等待网络空闲 500ms,适合动态内容。
限制与说明:资料未提供收费、价格与平台信息。整页截图对超长页面耗时更长;截图先以 PNG 临时保存再编码。资料另附针对 Cloudflare 的绕过思路(stealth 插件、指纹随机化、持久会话、代理轮换、CAPTCHA 检测与 2Captcha 等),相关依赖为 npm install playwright-extra playwright-extra-plugin-stealth 或 pip install playwright playwright-stealth,属于可选进阶内容,实际效果与合规性需自行评估。