跳到正文

事件与调试

哪些页面事件会到达你的自动化客户端,如何仍然捕获控制台输出,以及如何检查页面实际由哪个渲染器绘制。

控制台与页面错误事件

引擎不会把控制台事件或页面错误事件转发给自动化客户端,因此 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()