Zum Inhalt springen

Events und Debugging

Welche Seiten-Events Ihren Automatisierungs-Client erreichen, wie Sie die Konsolenausgabe trotzdem mitschneiden und wie Sie prüfen, welcher Renderer die Seite tatsächlich zeichnet.

Console- und Page-Error-Events

Die Engine leitet Console- und Page-Error-Events nicht an Automatisierungs-Clients weiter, daher empfangen page.on("console") und page.on("pageerror") nichts. Das ist Absicht — genau diese Weiterleitung misst eine Probe, die nach Automatisierung sucht. In-Page-Handler für window.onerror und unhandledrejection feuern ganz normal; um die Konsolenausgabe mitzuschneiden, sammeln Sie sie also in der Seite und lesen sie mit page.evaluate() zurück. Die Python-, Node- und .NET-SDKs weisen beim Start einmalig darauf hin, außer wenn stock_runtime (siehe unten) die Unterdrückung abgeschaltet hat.

Zwei Treiberaufrufe hängen von diesen Events ab. page.setContent() von Playwright wartet auf ein Console-Event und läuft deshalb in einen Timeout (in Puppeteer funktioniert der Aufruf): Öffnen Sie das HTML als data:-URL, oder schreiben Sie es mit page.evaluate() in die Seite. exposeFunction() und exposeBinding() funktionieren in Playwright und Puppeteer in der Seite, die beim Aufruf geöffnet ist, und verschwinden, sobald diese Seite navigiert: Rufen Sie sie nach der letzten Navigation auf, oder geben Sie Ergebnisse über page.evaluate() zurück.

Für einen Debugging-Lauf wieder einschalten (stock_runtime)

Ab dem lizenzierten Build 154 r32 können Sie die Unterdrückung abschalten. Übergeben Sie mit SDK 0.41.0 oder neuer stock_runtime=True (Node stockRuntime: true, .NET StockRuntime = true) oder setzen Sie CLEARCOTE_STOCK_RUNTIME=1, dann ist das Standardverhalten der DevTools-Runtime zurück: page.on("console") und page.on("pageerror") empfangen Events, page.setContent() von Playwright funktioniert, und exposeFunction() / exposeBinding() funktionieren auch nach einer Navigation weiter. Das SDK fügt den Engine-Switch --disable-runtime-suppression genau einmal hinzu; mit reinem Playwright ohne SDK übergeben Sie diesen Switch selbst in 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()
  • Standardmäßig aus. Wer die Option einschaltet, stellt genau das oben beschriebene Signal wieder her, das Seiten beobachten können; nutzen Sie sie also beim Debuggen und nicht in Produktion. Eine explizite Option hat Vorrang vor der Variablen (1, true, yes oder on schalten sie ein).
  • Braucht eine Engine, die den Switch kennt (lizenzierter Build ab r32). Auf einer älteren Engine oder dem offenen Build startet das SDK ohne ihn und warnt einmal pro Prozess; quiet und CLEARCOTE_NO_WARN unterdrücken das.
  • Lokale und Docker-Launches. Ein Docker-Launch reicht die Option an den Container weiter, dessen Entrypoint sie nur auf einer Engine beibehält, die sie kennt (seine serve-state-Zeile meldet stock_runtime); in Ihrem eigenen docker run setzen Sie --disable-runtime-suppression in CC_EXTRA_ARGS. Ein Cloud-Launch wendet sie nicht an und weist einmal darauf hin.
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)

Kohärenzprüfung des Render-Backends (checkRenderCoherence)

Eine Persona kann eine GPU angeben. Wird die Seite aber tatsächlich von einem Software-Rasterizer gezeichnet (SwiftShader / llvmpipe — headless ohne GPU üblich), kann ein strenger Detektor das erkennen. Prüfen Sie eine geladene Seite: Die Funktion liest den (unmaskierten) WebGL-Vendor/-Renderer, den die Seite tatsächlich sieht, meldet einen Fallback auf einen Software-Rasterizer (ein fatales Headless-Indiz — aktivieren Sie die Canvas-Bridge oder starten Sie headed auf einer echten GPU) oder ein inkohärentes Vendor/Renderer-Paar und liefert ein strukturiertes Ergebnis zurück. Übergeben Sie die angegebene GPU, um zusätzlich die gerenderte GPU-Familie zu prüfen. Verfügbar synchron, asynchron und in 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()