> 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/es/headless-browser/features/handling-captcha-events.md). # Gestión de eventos CAPTCHA ### Método basado en eventos Para supervisar el proceso de resolución del CAPTCHA, recomendamos usar el método basado en eventos. Permite a su script escuchar mensajes personalizados enviados directamente desde la extensión. #### Cómo funciona La extensión envía un mensaje al objeto `window` del navegador. Puedes capturarlos agregando un escuchador de eventos "message". | `oxylabs-captcha-solve-start` | Se ha detectado el CAPTCHA y la resolución ha comenzado. | | ----------------------------- | -------------------------------------------------------- | | `oxylabs-captcha-solve-end` | El CAPTCHA se resolvió correctamente. | | `oxylabs-captcha-solve-error` | El solucionador automático no pudo omitir el CAPTCHA. | Puede suscribirse a estos eventos para pausar su automatización y reanudarla solo después de que el CAPTCHA se haya gestionado correctamente. Normalmente, el manejo del CAPTCHA tarda hasta 30 segundos, según el tipo y la complejidad del CAPTCHA, pero en algunos casos puede tardar más, así que deje tiempo para que termine la gestión del CAPTCHA. #### Ejemplos 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/es/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.