Eventos y depuración
Qué eventos de la página llegan a tu cliente de automatización, cómo capturar de todos modos la salida de la consola y cómo comprobar qué renderizador pinta realmente la página.
Eventos de consola y de errores de página
El motor no reenvía los eventos de consola ni de errores de página a los clientes de automatización, así que page.on("console") y page.on("pageerror") no reciben nada. Es así por diseño: reenviarlos es precisamente lo que mide una sonda de presencia de automatización. Los handlers window.onerror y unhandledrejection dentro de la página se disparan con normalidad, así que, para capturar la salida de la consola, recógela dentro de la página y léela con page.evaluate(). Los SDK de Python, Node y .NET muestran un aviso sobre esto una sola vez, al lanzar, salvo cuando stock_runtime (más abajo) haya desactivado la supresión.
Dos llamadas del driver dependen de esos eventos. page.setContent() de Playwright espera un evento de consola, así que se agota el tiempo de espera (el de Puppeteer funciona): abre el HTML como una URL data: o escríbelo en la página con page.evaluate(). exposeFunction() y exposeBinding(), en Playwright y Puppeteer, funcionan en la página que está abierta cuando las llamas y desaparecen en cuanto esa página navega: llámalas después de la última navegación o devuelve los resultados desde page.evaluate().
Vuelve a activarlos para una ejecución de depuración (stock_runtime)
A partir del build con licencia 154 r32 puedes desactivar la supresión. Con el SDK 0.41.0 o posterior, pasa stock_runtime=True (en Node, stockRuntime: true; en .NET, StockRuntime = true) o define CLEARCOTE_STOCK_RUNTIME=1, y vuelve el comportamiento estándar de Runtime de DevTools: page.on("console") y page.on("pageerror") reciben eventos, page.setContent() de Playwright funciona y exposeFunction() / exposeBinding() siguen funcionando después de una navegación. El SDK agrega el switch del motor, --disable-runtime-suppression, una sola vez; con Playwright directo y sin el SDK, pasa tú mismo ese switch en 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()- Desactivado por defecto. Activarlo restaura exactamente la señal descrita arriba, que las páginas pueden observar, así que úsalo mientras depuras y no en producción. Una opción explícita tiene prioridad sobre la variable (
1,true,yesuonlo activan). - Requiere un motor que tenga el switch (build con licencia desde r32). Con un motor más antiguo o con el build abierto, el SDK lanza sin él y avisa una vez por proceso;
quietyCLEARCOTE_NO_WARNsilencian ese aviso. - Lanzamientos locales y en Docker. Un lanzamiento en Docker se lo pasa al contenedor, cuyo entrypoint lo conserva solo en un motor que lo tenga (su línea
serve-statereportastock_runtime); en tu propiodocker run, pon--disable-runtime-suppressionenCC_EXTRA_ARGS. Un lanzamiento en la nube no lo aplica y lo indica una vez.
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)Comprobación de coherencia del backend de renderizado (checkRenderCoherence)
Una persona puede declarar una GPU, pero si en realidad la página la pinta un rasterizador por software (SwiftShader / llvmpipe, algo habitual en headless sin GPU), un detector estricto puede notarlo. Analiza una página en vivo: la función lee el vendor/renderer de WebGL (sin enmascarar) que la página ve realmente, señala un fallback a rasterizador por software (una señal fatal de headless: activa el canvas bridge o ejecuta en modo headed sobre una GPU real) o un par vendor/renderer incoherente, y devuelve un veredicto estructurado. Pasa la GPU declarada para comprobar también la familia renderizada. Disponible en síncrono, en asíncrono y 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()