# Tratamento de Eventos de CAPTCHA ### Método Baseado em Eventos Para monitorar o processo de resolução de CAPTCHA, recomendamos usar o método Baseado em Eventos. Ele permite que seu script escute mensagens personalizadas enviadas diretamente pela extensão. #### Como funciona A extensão envia uma mensagem para o `window` objeto do navegador. Você pode capturá-las adicionando um ouvinte de evento "message". | | | | ----------------------------- | ------------------------------------------------------ | | `oxylabs-captcha-solve-start` | O CAPTCHA foi detectado e a resolução começou. | | `oxylabs-captcha-solve-end` | O CAPTCHA foi resolvido com sucesso. | | `oxylabs-captcha-solve-error` | O resolvedor automático falhou ao contornar o CAPTCHA. | Você pode assinar esses eventos para pausar sua automação e retomar somente depois que o CAPTCHA tiver sido tratado com sucesso. Normalmente, a resolução de CAPTCHA leva até 30 segundos, dependendo do tipo e da complexidade do CAPTCHA, mas em alguns casos pode levar mais tempo, então aguarde até que a resolução do CAPTCHA termine. #### Exemplos de código {% tabs %} {% tab title="Python (Playwright)" %} ```python import sys from playwright.sync_api import sync_playwright # Configuration EXTENSION_NAME = 'oxylabs-runtime' CAPTCHA_SOLVE_END = 'oxylabs-captcha-solve-end' CAPTCHA_SOLVE_ERROR = 'oxylabs-captcha-solve-error' UB_BROWSER_URL = 'wss://:@ubc.oxylabs.io' CAPTCHA_CHECK_TIMEOUT_SEC = 60 TARGET_URL = 'https://www.indeed.com/cmp/Bank-of-the-West/reviews?lang=any&fcountry=ALL&sort=date' def run(): with sync_playwright() as p: print('Opening browser page...') # Connect to the remote browser using CDP browser = p.chromium.connect_over_cdp(UB_BROWSER_URL) # Get the default context and create a new page ctx = browser.contexts[0] page = ctx.new_page() # This must be done BEFORE navigation. ctx.add_init_script(f""" window.addEventListener("message", (event) => {{ if (event.data && event.data.source === "{EXTENSION_NAME}") {{ window.__extensionStatus = event.data.type; }} }}); """) print('Opening target website...') page.goto(TARGET_URL, wait_until='domcontentloaded') try: # Wait for the extension status to change page.wait_for_function( """ ([solveEnd, solveError]) => { const status = window.__extensionStatus; if (status === solveError) { throw new Error("CAPTCHA solving failed"); } return status === solveEnd; } """, arg=[CAPTCHA_SOLVE_END, CAPTCHA_SOLVE_ERROR], timeout=CAPTCHA_CHECK_TIMEOUT_SEC * 1000 ) print('CAPTCHA solved successfully, continue scraping...') except Exception as err: print(f'Error during CAPTCHA solve: {err}') browser.close() sys.exit(1) page.wait_for_selector('h1[data-testid="PageHeader-title-reviews"]') page.screenshot(path='page_screenshot.jpg') page.close() browser.close() print('Done.') if __name__ == "__main__": run() ``` {% endtab %} {% tab title="JavaScript (Playwright)" %} ```javascript const { chromium } = require('playwright'); const EXTENSION_NAME = 'oxylabs-runtime', CAPTCHA_SOLVE_END = 'oxylabs-captcha-solve-end', CAPTCHA_SOLVE_ERROR = 'oxylabs-captcha-solve-error', UB_BROWSER_URL = 'wss://:@ubc.oxylabs.io', CAPTCHA_CHECK_TIMEOUT_SEC = 60, TARGET_URL = 'https://www.indeed.com/cmp/Bank-of-the-West/reviews?lang=any&fcountry=ALL&sort=date'; (async () => { console.log('Opening browser page...'); const browser = await chromium.connectOverCDP(UB_BROWSER_URL); const ctx = browser.contexts()[0]; const page = await ctx.newPage(); // This must be done BEFORE navigation. await ctx.addInitScript((extensionName) => { window.addEventListener("message", (e) => { if (e.data?.source !== extensionName) return; window.__extensionStatus = e.data.type; }); }, EXTENSION_NAME); console.log('Opening target website...'); await page.goto(TARGET_URL, { waitUntil: 'domcontentloaded' }); try { await page.waitForFunction( ([solveEnd, solveError]) => { const status = window.__extensionStatus; if (status === solveError) { throw new Error("CAPTCHA solving failed"); } return status === solveEnd; }, [CAPTCHA_SOLVE_END, CAPTCHA_SOLVE_ERROR], { timeout: CAPTCHA_CHECK_TIMEOUT_SEC * 1000 } ); console.log('CAPTCHA solved successfully, continue scraping...'); } catch (err) { console.error('Error during CAPTCHA solve:', err.message); await browser.close(); process.exit(1); } await page.waitForSelector('h1[data-testid="PageHeader-title-reviews"]'); await page.screenshot({ path: 'page_screenshot.jpg' }); await page.close(); await browser.close(); console.log('Done.'); })(); ``` {% endtab %} {% tab title="JavaScript (Puppeteer)" %} ```javascript const puppeteer = require('puppeteer'); const EXTENSION_NAME = 'oxylabs-runtime', CAPTCHA_SOLVE_END = 'oxylabs-captcha-solve-end', CAPTCHA_SOLVE_ERROR = 'oxylabs-captcha-solve-error', UB_BROWSER_URL = 'wss://:@ubc.oxylabs.io', CAPTCHA_CHECK_TIMEOUT_SEC = 60, TARGET_URL = 'https://www.indeed.com/cmp/Bank-of-the-West/reviews?lang=any&fcountry=ALL&sort=date'; (async () => { console.log('Opening browser page...'); const browser = await puppeteer.connect({ browserWSEndpoint: UB_BROWSER_URL, }); const page = await browser.newPage(); // This must be done BEFORE navigation. await page.evaluateOnNewDocument((extensionName) => { window.addEventListener("message", (e) => { if (e.data?.source !== extensionName) return; window.__extensionStatus = e.data.type; }); }, EXTENSION_NAME); console.log('Opening target website...'); await page.goto(TARGET_URL, { waitUntil: 'domcontentloaded' }); try { await page.waitForFunction( (solveEnd, solveError) => { const status = window.__extensionStatus; if (status === solveError) { throw new Error("CAPTCHA solving failed"); } return status === solveEnd; }, { timeout: CAPTCHA_CHECK_TIMEOUT_SEC * 1000 }, CAPTCHA_SOLVE_END, CAPTCHA_SOLVE_ERROR ); console.log('CAPTCHA solved successfully, continue scraping...'); } catch (err) { console.error('Error during CAPTCHA solve:', err.message); await browser.close(); process.exit(1); } await page.waitForSelector('h1[data-testid="PageHeader-title-reviews"]'); await page.screenshot({ path: 'page_screenshot.jpg' }); await page.close(); await browser.disconnect(); console.log('Done.'); })(); ``` {% endtab %} {% endtabs %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://developers.oxylabs.io/products/pt-br/headless-browser/features/handling-captcha-events.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.