Custom CDP Functions - Bright Data Docs

Captcha Solver

When navigating a page with Scraping Browser, our integrated CAPTCHA solver automatically solves all CAPTCHAs by default. You can monitor this auto-solving process in your code with the following custom CDP functions.

If you would like to disable CAPTCHA solver entirely through the Control Panel see our feature for Disable Captcha Solver

Once a CAPTCHA is solved, if there is a form to submit, it will be submitted by default.

CAPTCHA Solver - Automatic Solve

Use the commands below to pinpoint a more specific stage in the CAPTCHA solving flow:


`Captcha.detected`	Scraping Browser has encountered a CAPTCHA and has begun to solve it
`Captcha.solveFinished`	Scraping Browser successfully solved the CAPTCHA
`Captcha.solveFailed`	Scraping Browser failed in solving the CAPTCHA
`Captcha.waitForSolve`	Scraping Browser waits for CAPTCHA solver to finish

Examples

The following code sets up a CDP session, listens for CAPTCHA events, and handles timeouts:

CAPTCHA Solver - Manual Control

If you would like to either manually configure or fully disable our default CAPTCHA solver and instead call the solver manually or solve on your own, see the following CDP commands and functionality.

For the following three CAPTCHA types we support the following additional options to control and configure our auto-solving algorithm.

CF Challenge
timeout: 40000  
selector: '#challenge-body-text, .challenge-form'  
check_timeout: 300  
error_selector: '#challenge-error-title'  
success_selector: '#challenge-success[style*=inline]'  
check_success_timeout: 300  
btn_selector: '#challenge-stage input[type=button]'  
cloudflare_checkbox_frame_selector: '#turnstile-wrapper iframe'  
checkbox_area_selector: '.ctp-checkbox-label .mark'  
wait_timeout_after_solve: 500  
wait_networkidle: {timeout: 500}

Emulation Functions

Use this command to get a list of all possible devices that can be emulated. This method returns an array of device options that can be used with the setDevice command.

Example
Emulation.getSupportedDevices().then(devices => { console.log(devices);});

Once you’ve received the list above of supported devices, you can emulate a specific device using the Emulation.setDevice command. This command changes the screen width, height, userAgent, and devicePixelRatio to match the specified device.

Landscape mode

If you wish to change the orientation to landscape (for devices that support it), add the string landscape after the device_name.

Example
Emulation.setDevice({device: 'iPhone X landscape'});

Custom Client SSL/TLS Certificates

Use this command to install custom client SSL/TLS certificates where required for specific domain authentication. These certificates are applied for the duration of a single Scraping Browser session and are automatically removed once the session ends.

​Captcha Solver

​CAPTCHA Solver - Automatic Solve

​CAPTCHA Solver - Manual Control

​Emulation Functions