Aller au contenu

Événements et débogage

Quels événements de page parviennent à votre client d'automatisation, comment récupérer quand même la sortie de la console, et comment vérifier quel backend de rendu dessine réellement la page.

Événements console et erreurs de page

Le moteur ne transmet pas les événements de console ni d’erreur de page aux clients d’automatisation : page.on("console") et page.on("pageerror") ne reçoivent donc rien. C’est voulu — les transmettre est précisément ce que mesure une sonde de détection de l’automatisation. Dans la page, les handlers window.onerror et unhandledrejection se déclenchent normalement : pour capturer la sortie console, collectez-la dans la page et relisez-la avec page.evaluate(). Au lancement, les SDK Python, Node et .NET affichent une note à ce sujet (une seule fois), sauf si stock_runtime (ci-dessous) a désactivé la suppression.

Deux appels du driver dépendent de ces événements. Dans Playwright, page.setContent() attend un événement de console et finit donc en timeout (dans Puppeteer, il fonctionne) : ouvrez le HTML sous forme d’URL data:, ou écrivez-le dans la page avec page.evaluate(). Dans Playwright comme dans Puppeteer, exposeFunction() et exposeBinding() fonctionnent dans la page ouverte au moment de l’appel, et disparaissent dès que cette page navigue : appelez-les après la dernière navigation, ou faites remonter les résultats avec page.evaluate().

Les rétablir pour une session de débogage (stock_runtime)

À partir du build sous licence 154 r32, vous pouvez désactiver la suppression. Avec le SDK 0.41.0 ou plus récent, passez stock_runtime=True (Node stockRuntime: true, .NET StockRuntime = true) ou définissez CLEARCOTE_STOCK_RUNTIME=1, et le comportement standard du Runtime DevTools revient : page.on("console") et page.on("pageerror") reçoivent les événements, le page.setContent() de Playwright fonctionne, et exposeFunction() / exposeBinding() continuent de fonctionner après une navigation. Le SDK ajoute le switch du moteur, --disable-runtime-suppression, une seule fois ; avec Playwright brut, sans SDK, passez vous-même ce switch dans 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()
  • Désactivé par défaut. L’activer rétablit exactement le signal décrit plus haut, que les pages peuvent observer ; utilisez-le donc pendant le débogage plutôt qu’en production. Une option explicite l’emporte sur la variable (1, true, yes ou on l’activent).
  • Nécessite un moteur doté du switch (build sous licence à partir de la r32). Sur un moteur plus ancien ou sur le build ouvert, le SDK se lance sans lui et avertit une fois par processus ; quiet et CLEARCOTE_NO_WARN font taire cet avertissement.
  • Lancements locaux et Docker. Un lancement Docker le transmet au conteneur, dont l’entrypoint ne le conserve que sur un moteur qui le possède (sa ligne serve-state indique stock_runtime) ; dans votre propre docker run, mettez --disable-runtime-suppression dans CC_EXTRA_ARGS. Un lancement cloud ne l’applique pas et le signale une fois.
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)

Vérifier la cohérence du backend de rendu (checkRenderCoherence)

Une persona peut annoncer un GPU, mais si la page est en réalité rendue par un rasterizer logiciel (SwiftShader / llvmpipe — courant en headless sans GPU), un détecteur strict peut s’en apercevoir. Sondez une page active : la vérification lit le vendor/renderer WebGL (non masqué) que la page voit réellement, signale un repli sur un rasterizer logiciel (un indice headless rédhibitoire — activez le canvas bridge ou lancez en mode headed sur un vrai GPU) ou une paire vendor/renderer incohérente, et renvoie un verdict structuré. Passez le GPU annoncé pour contrôler aussi la famille effectivement rendue. Disponible en synchrone, en asynchrone et en 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()