如何在Puppeteer中注入Cloudflare Turnstile令牌并触发验证回调

你已经成功获取并设置了cf-turnstile-response令牌，但缺少触发验证完成的关键步骤，以下是几种针对Turnstile的可行方案：

方法1：通过Turnstile全局API触发回调 #

Cloudflare Turnstile提供了全局window.turnstile对象，可直接获取已渲染的widget并调用其回调函数：

// 等待Turnstile全局对象加载完成
await page.waitForFunction(() => typeof window.turnstile !== 'undefined');

// 注入令牌并触发验证回调
await page.evaluate((token) => {
    // 先设置令牌到对应输入框
    document.querySelector('[name="cf-turnstile-response"]').value = token;
    
    // 获取所有已渲染的Turnstile widget ID列表
    const widgetIds = window.turnstile.getWidgetIds();
    
    // 遍历每个widget，执行其验证成功回调
    widgetIds.forEach(id => {
        const config = window.turnstile.getWidgetConfig(id);
        if (typeof config.callback === 'function') {
            config.callback(token);
        }
    });
}, YOUR_TURNSTILE_TOKEN);

方法2：模拟验证成功的DOM事件 #

部分网站会监听Turnstile元素的DOM事件来感知验证状态，可尝试触发这些事件：

await page.evaluate((token) => {
    const turnstileInput = document.querySelector('[name="cf-turnstile-response"]');
    turnstileInput.value = token;
    
    // 触发标准change事件
    turnstileInput.dispatchEvent(new Event('change', { bubbles: true }));
    
    // 尝试触发Turnstile常见的自定义成功事件
    turnstileInput.dispatchEvent(new CustomEvent('cf-turnstile-success', { 
        detail: token, 
        bubbles: true 
    }));
}, YOUR_TURNSTILE_TOKEN);

方法3：查找网站自定义的验证回调 #

很多网站会在Turnstile初始化时传入自定义回调，可通过全局对象或DOM属性定位：

await page.evaluate((token) => {
    // 遍历全局对象，查找可能的验证回调函数
    for (const prop in window) {
        if ((prop.includes('turnstile') || prop.includes('callback')) && typeof window[prop] === 'function') {
            try {
                window[prop](token);
            } catch (e) {
                // 跳过无效回调，继续查找
            }
        }
    }
    
    // 检查Turnstile容器的data属性，部分网站会在这里存储回调名
    const turnstileContainer = document.querySelector('.cf-turnstile');
    if (turnstileContainer?.dataset.callback) {
        const callbackFn = window[turnstileContainer.dataset.callback];
        if (typeof callbackFn === 'function') {
            callbackFn(token);
        }
    }
}, YOUR_TURNSTILE_TOKEN);

注意事项 #

• 令牌必须与当前页面会话绑定，否则即使触发回调，网站也可能验证失败
• 避免频繁重复触发，防止被Cloudflare检测为自动化行为
• 部分网站会额外验证cf-turnstile-response的签名或会话一致性，需确保令牌的有效性

内容的提问来源于stack exchange，提问作者Ronald Navarrete