事件与调试
哪些页面事件会到达你的自动化客户端,如何仍然捕获控制台输出,以及如何检查页面实际由哪个渲染器绘制。
控制台与页面错误事件
引擎不会把控制台事件或页面错误事件转发给自动化客户端,因此 page.on("console") 和 page.on("pageerror") 收不到任何内容。这是有意为之——检测自动化是否存在的探针,测的恰恰就是这种转发。页面内的 window.onerror 和 unhandledrejection 处理函数会正常触发,所以要捕获控制台输出,请在页面内收集,再用 page.evaluate() 读回来。Python、Node 和 .NET SDK 会在启动时就此打印一次提示,除非 stock_runtime(见下文)已关闭这种抑制。
有两个驱动调用依赖这些事件。Playwright 的 page.setContent() 会等待一个控制台事件,因此会超时(Puppeteer 的可以正常使用):请以 data: URL 的形式打开 HTML,或者用 page.evaluate() 把它写入页面。在 Playwright 和 Puppeteer 中,exposeFunction() 和 exposeBinding() 在调用时已打开的页面中生效,该页面一旦发生导航就会失效:请在最后一次导航之后再调用它们,或者通过 page.evaluate() 把结果传回。
在调试运行中重新开启(stock_runtime)
从授权版 154 r32 构建起,你可以关闭这种抑制。使用 SDK 0.41.0 或更高版本时,传入 stock_runtime=True(Node 为 stockRuntime: true,.NET 为 StockRuntime = true)或设置 CLEARCOTE_STOCK_RUNTIME=1,标准的 DevTools Runtime 行为就会恢复:page.on("console") 和 page.on("pageerror") 能收到事件,Playwright 的 page.setContent() 可以正常使用,exposeFunction() / exposeBinding() 在导航之后也能继续工作。SDK 会添加一次引擎开关 --disable-runtime-suppression;如果直接使用 Playwright 而不用 SDK,请自己在 args 中传入这个开关。
from clearcote import launch
browser = launch(fingerprint="seed-123", stock_runtime=True) # or CLEARCOTE_STOCK_RUNTIME=1
page = browser.new_page()
page.on("console", lambda msg: print("console:", msg.text))
page.set_content("<script>console.log('hello')</script>") # works with stock_runtime
browser.close()- 默认关闭。开启后恢复的正是上文所述、页面能够察觉的那个信号,因此请在调试时使用,而不要用于生产环境。显式传入的选项优先于环境变量(
1、true、yes或on表示开启)。 - 需要带有该开关的引擎(r32 起的授权版构建)。在较旧的引擎或开源版构建上,SDK 会在不启用它的情况下启动,并在每个进程中警告一次;
quiet和CLEARCOTE_NO_WARN可以关闭该警告。 - 适用于本地和 Docker 启动。Docker 启动会把它交给容器,容器的入口点只在引擎带有该开关时才保留它(其
serve-state行会报告stock_runtime);在你自己的docker run中,请把--disable-runtime-suppression放进CC_EXTRA_ARGS。云端启动不会应用它,并会就此提示一次。
from urllib.parse import quote
# Instead of page.set_content(html):
# short HTML: a data: URL (the page gets no origin of its own, so no cookies or storage)
page.goto("data:text/html," + quote(html))
# any HTML: write it into a page you have navigated to; it keeps that page's origin
page.evaluate("html => { document.open(); document.write(html); document.close(); }", html)渲染后端一致性检查(checkRenderCoherence)
身份画像可以声称自己用的是某块 GPU,但如果页面实际上是由软件光栅化器绘制的(SwiftShader / llvmpipe——在没有 GPU 的无头环境中很常见),严格的检测器就能分辨出来。对一个已打开的页面执行探测:它会读取页面实际看到的(未屏蔽的)WebGL vendor/renderer,标记出软件光栅化器回退(这是致命的无头破绽——请启用 canvas bridge,或在真实 GPU 上以有头模式运行)或不一致的 vendor/renderer 组合,并返回结构化的判定结果。传入声称的 GPU,还可以同时断言实际渲染的 GPU 系列。同步、异步和 Node 版本均可用。
from clearcote import launch, check_render_coherence
browser = launch(fingerprint="seed-123")
page = browser.new_page(); page.goto("about:blank")
verdict = check_render_coherence(page) # {'renderer', 'software_suspected', 'coherent', 'warnings'}
if not verdict["coherent"]:
print(verdict["warnings"]) # e.g. software rasterizer / incoherent GPU family
browser.close()