イベントとデバッグ
どのページイベントが自動化クライアントに届くのか、届かないコンソール出力を取得する方法、そしてページを実際に描画しているレンダラーを確認する方法を説明します。
コンソールとページエラーのイベント
エンジンはコンソールやページエラーのイベントを自動化クライアントに転送しないため、page.on("console") と page.on("pageerror") は何も受け取りません。これは意図した設計です。これらのイベントを転送すること自体が、自動化の存在を探るプローブの計測対象だからです。ページ内の window.onerror と unhandledrejection のハンドラーは通常どおり発火するので、コンソール出力を取得したい場合はページ内で収集し、page.evaluate() で読み出してください。Python、Node、.NET の SDK は、起動時にこの点について一度だけ注意を表示します。ただし、stock_runtime(後述)で抑制をオフにしている場合は表示しません。
これらのイベントに依存するドライバーの呼び出しが 2 つあります。Playwright の page.setContent() はコンソールイベントを待つため、タイムアウトします(Puppeteer では動作します)。HTML を data: URL として開くか、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 を一度だけ追加します。SDK を使わずに素の Playwright で起動する場合は、このスイッチを自分で 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を実行する場合は、CC_EXTRA_ARGSに--disable-runtime-suppressionを入れてください。クラウドでの起動ではこれは適用されず、その旨が一度だけ通知されます。
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 のベンダー/レンダラーを読み取り、ソフトウェアラスタライザーへのフォールバック(ヘッドレスであることを決定的に示す手がかりです。canvas ブリッジを有効にするか、実際の GPU 上で headed モードで実行してください)や、整合しないベンダー/レンダラーの組み合わせを検出して、構造化された判定結果を返します。名乗っている 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()