Eventos e depuração
Quais eventos da página chegam ao seu cliente de automação, como capturar a saída do console mesmo assim e como conferir qual renderizador realmente pinta a página.
Eventos de console e de erro de página
O motor não repassa eventos de console nem de erro de página para clientes de automação, então page.on("console") e page.on("pageerror") não recebem nada. Isso é intencional — repassá-los é exatamente o que uma sonda de presença de automação mede. Os handlers window.onerror e unhandledrejection dentro da página disparam normalmente; então, para capturar a saída do console, colete-a na própria página e leia de volta com page.evaluate(). Os SDKs de Python, Node e .NET exibem um aviso sobre isso, uma única vez, na inicialização, exceto quando o stock_runtime (abaixo) desligou a supressão.
Duas chamadas do driver dependem desses eventos. O page.setContent() do Playwright espera por um evento de console, então dá timeout (o do Puppeteer funciona): abra o HTML como uma URL data: ou escreva-o na página com page.evaluate(). O exposeFunction() e o exposeBinding(), no Playwright e no Puppeteer, funcionam na página que está aberta quando você os chama e somem assim que essa página navega: chame-os depois da última navegação ou devolva os resultados pelo page.evaluate().
Reative para uma execução de depuração (stock_runtime)
A partir do build licenciado 154 r32, você pode desligar a supressão. Com o SDK 0.41.0 ou mais novo, passe stock_runtime=True (no Node, stockRuntime: true; no .NET, StockRuntime = true) ou defina CLEARCOTE_STOCK_RUNTIME=1, e o comportamento padrão do Runtime do DevTools volta: page.on("console") e page.on("pageerror") recebem eventos, o page.setContent() do Playwright funciona, e exposeFunction() / exposeBinding() continuam funcionando depois de uma navegação. O SDK adiciona o switch do motor, --disable-runtime-suppression, uma única vez; com o Playwright puro, sem o SDK, passe você mesmo esse switch em 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()- Desligado por padrão. Ligá-lo restaura exatamente o sinal descrito acima, que as páginas conseguem perceber; por isso, use-o enquanto depura, e não em produção. Uma opção explícita tem prioridade sobre a variável (
1,true,yesouono ligam). - Exige um motor que tenha o switch (build licenciado a partir do r32). Num motor mais antigo ou no build aberto, o SDK inicia sem ele e avisa uma vez por processo;
quieteCLEARCOTE_NO_WARNsilenciam esse aviso. - Inicializações locais e no Docker. Uma inicialização no Docker o repassa ao contêiner, cujo entrypoint só o mantém num motor que o tenha (a linha
serve-statedele informastock_runtime); no seu própriodocker run, coloque--disable-runtime-suppressionemCC_EXTRA_ARGS. Uma inicialização na nuvem não o aplica e avisa isso uma 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)Verificação de coerência do backend de renderização (checkRenderCoherence)
Uma persona pode declarar uma GPU, mas, se a página for de fato pintada por um rasterizador de software (SwiftShader / llvmpipe — comum em headless sem GPU), um detector rigoroso consegue perceber. Verifique uma página carregada: a função lê o vendor/renderer do WebGL (sem máscara) que a página realmente vê, sinaliza um fallback para rasterizador de software (um indício fatal de headless — ative a canvas bridge ou rode em modo headed numa GPU real) ou um par vendor/renderer incoerente, e devolve um veredito estruturado. Passe a GPU declarada para conferir também a família renderizada. Disponível em versão síncrona, assíncrona e em 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()