> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/pt-br/headless-browser/features/handling-captcha-events.md). # 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. Você pode capturá-las adicionando um listener de evento "message". | `oxylabs-captcha-solve-start` | O CAPTCHA foi detectado e a resolução foi iniciada. | | ----------------------------- | ------------------------------------------------------ | | `oxylabs-captcha-solve-end` | O CAPTCHA foi resolvido com sucesso. | | `oxylabs-captcha-solve-error` | O resolvedor automático falhou em contornar o CAPTCHA. | Você pode se inscrever para esses eventos para pausar sua automação e retomar somente depois que o CAPTCHA tiver sido tratado com sucesso. Normalmente, o tratamento do CAPTCHA leva até 30 segundos, dependendo do tipo e da complexidade do CAPTCHA, mas em alguns casos pode levar mais tempo, então reserve tempo para o término do gerenciamento do CAPTCHA. #### 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 This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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.