自定义 CDP 函数

验证码解算器

使用抓取浏览器浏览页面时，默认情况下，我们的集成验证码解算器会自动解算所有验证码 。您可以使用以下自定义 CDP 函数在代码中监控此自动解算过程。

如果您想通过控制面板完全禁用验证码解算器，请参阅我们的禁用验证码解算器功能:
https://docs.brightdata.com/cn/scraping-automation/scraping-browser/features/captcha-solver

验证码解算后，如有表单需要提交，则默认情况下会提交。

验证码解算器 - 自动解算

Captcha.Solve

使用此指令返回验证码已解算、失败或未检测到之后的状态。 使用此指令返回验证码已解算、失败或未检测到之后的状态。

Captcha.Solve

Captcha.Solve({
    detectTimeout?: number // Detect timeout in millisecond for solver to detect captcha  
    options?: CaptchaOptions[] // Configuration options for captcha solving  
}) : SolveResult

示例

NodeJS - Puppeteer

const page = await browser.newPage();
const client = await page.target().createCDPSession();
await page.goto('[https://site-with-captcha.com](https://site-with-captcha.com/)');  

// Note 1: If no captcha was found it will return not_detected status after detectTimeout   
// Note 2: Once a CAPTCHA is solved, if there is a form to submit, it will be submitted by default   

const client = await page.target().createCDPSession();  
const {status} = await client.send('Captcha.Solve', {detectTimeout: 30*1000});   
console.log(`Captcha solve status: ${status}`)

如果验证码解算失败，请重新尝试。 如果问题仍然存在，请提交支持请求 ，详细说明您遇到的具体问题。

用于验证码状态的自定义 CDP 指令

使用以下指令查明验证码解算流程中更具体的阶段：

Captcha.detected	抓取浏览器遇到验证码并开始解算
Captcha.SolveFinished	抓取浏览器成功解算验证码
Captcha.SolveFailed	抓取浏览器未能解算验证码
Captcha.waitForSolve	抓取浏览器等待验证码解算器完成

示例

异步

以下代码设置 CDP 会话、监听 CAPTCHA 事件并处理超时：

NodeJS - Puppeteer

// Node.js - Puppeteer - waiting for CAPTCHA solving events  
const client = await page.target().createCDPSession();   
await new Promise((resolve, reject)=>{   
  client.on('Captcha.SolveFinished', resolve);   
  client.on('Captcha.SolveFailed', ()=>reject(new Error('Captcha failed')));   
  setTimeout(reject, 5 * 60 * 1000, new Error('Captcha solve timeout'));  
});

以下代码设置 CDP 会话、监听 CAPTCHA 事件并处理超时：

NodeJS - Puppeteer

// Node.js - Puppeteer - waiting for CAPTCHA solving events  
const client = await page.target().createCDPSession();   
await new Promise((resolve, reject)=>{   
  client.on('Captcha.SolveFinished', resolve);   
  client.on('Captcha.SolveFailed', ()=>reject(new Error('Captcha failed')));   
  setTimeout(reject, 5 * 60 * 1000, new Error('Captcha solve timeout'));  
});

Selenium doesn’t support asynchronous server-driven events like Puppeteer and Playwright.

The Captcha.waitForSolve command waits for 抓取浏览器’s CAPTCHA solver to finish.

Python - Selenium

# Python Selenium - Waiting for Captcha to auto-solve after navigate  
driver.execute('executeCdpCommand', {  
    'cmd': 'Captcha.waitForSolve',  
    'params': {},  
})

验证码解算器 - 手动控制

如果您想手动配置或完全禁用我们的默认验证码解算器，请改为手动调用解算器或自己解算，请参阅以下 CDP 指令和功能。

Captcha.setAutoSolve

此指令用于控制验证码的自动解算。 您可以禁用自动解算或为不同的验证码类型配置算法，然后手动触发此操作：

Captcha.setAutoSolve

Captcha.setAutoSolve({  
  autoSolve: boolean // Whether to automatically solve captcha after navigate  
  options?: CaptchaOptions[] // Configuration options for captcha auto-solving  
}) : void

在会话中完全禁用自动解算器的 CDP 指令示例：

NodeJS - Puppeteer

// Node.js Puppeteer - Disable Captcha auto-solver completely  
const page = await browser.newPage();  
const client = await page.target().createCDPSession();  
await client.send('Captcha.setAutoSolve', { autoSolve: false })

仅针对特定验证码类型禁用自动解算器 - 示例

NodeJS - Puppeteer

// Node.js Puppeteer - Disable Captcha auto-solver for ReCaptcha only  
const page = await browser.newPage();  
const client = await page.target().createCDPSession();  
await client.send('Captcha.setAutoSolve', {  
    autoSolve: true,  
    options: [{  
        type: 'usercaptcha',  
        disabled: true,  
    }],  
});

手动解算验证码 - 示例

NodeJS - Puppeteer

// Node.js Puppeteer - manually solving CAPTCHA after navigation  
const page = await browser.newPage();  
const client = await page.target().createCDPSession();  
await client.send('Captcha.setAutoSolve', { autoSolve: false });  
await page.goto('https://site-with-captcha.com', { timeout: 2*60*1000 });  
const {status} = await client.send('Captcha.Solve', { detectTimeout: 30*1000 });  
console.log('Captcha solve status:', status);

其他验证码类型的 CaptchaOptions

对于以下三种验证码类型，我们支持以下附加选项，以控制和配置我们的自动解算算法。

CF Challenge

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}

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}

HCaptcha

detect_selector:  
  '#cf-hcaptcha-container, #challenge-hcaptcha-wrapper .hcaptcha-box, .h-captcha'  
pass_proxy: true  
submit_form: true  
submit_selector: '#challenge-form body > form[action*="internalcaptcha/captchasubmit"]  
value_selector: '.h-captcha textarea[id^="h-captcha-response"]'  
  

UserCaptcha (reCAPTCHA)

{ // configuration keys and default values for reCAPTCHA (type=usercaptcha)  
  type: 'usercaptcha',  
  // selector to retrieve sitekey and/or action  
  selector: '.g-recaptcha, .recaptcha',  
  // attributes to search for sitekey  
  sitekey_attributes: ['data-sitekey', 'data-key'],  
  // attributes to search for action  
  action_attributes: ['data-action'],  
  // detect selectors  
  detect_selector: `  
    .g-recaptcha[data-sitekey] > *,  
    .recaptcha > *,  
    iframe[src*="[www.google.com/recaptcha/api2](http://www.google.com/recaptcha/api2)"],  
    iframe[src*="[www.recaptcha.net/recaptcha/api2](http://www.recaptcha.net/recaptcha/api2)"],  
    iframe[src*="[www.google.com/recaptcha/enterprise](http://www.google.com/recaptcha/enterprise)"]`,  
  // element to type response code into  
  reponse_selector: '#g-recaptcha-response, .g-recaptcha-response',  
  // should solver submit form automatically after captcha solved  
  submit_form: true,  
  // selector for submit button  
  submit_selector: '[type=submit]',  
}

仿真函数

Emulation.getSupportedDevices

使用此指令获取所有可仿真的设备列表。 此方法返回可与 setDevice 指令一起使用的设备选项阵列。

示例

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

Emulation.setDevice

收到上面的支持设备列表后，您可以使用 Emulation.setDevice 指令模拟特定设备。此指令更改屏幕宽度、高度、userAgent 和 devicePixelRatio 以匹配指定的设备。

Usage

Emulation.setDevice({device: '[device_name]'});

横向模式

如果您想将方向更改为横向（适用于支持横向的设备），可在device_name 之后添加字符串landscape。

示例

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