如何通过Selenium Python检测hCaptcha iframe的可见性

问题根源 #

hCaptcha的iframe通常会提前加载进DOM，但通过CSS（比如display:none、visibility:hidden、opacity:0）或视口外定位的方式隐藏，导致Selenium自带的EC.visibility_of_element_located无法准确判断其真实可见状态——这个方法仅检查元素是否存在且基础可见属性达标，无法覆盖所有隐藏场景。

解决方案：用JavaScript精准检测可见性 #

直接通过JavaScript获取元素的计算样式、尺寸和视口位置，判断其是否真正显示在页面上。

步骤1：精准定位hCaptcha iframe

别用By.TAG_NAME（容易匹配其他iframe），用hCaptcha专属属性定位，比如：

• 通过src包含hcaptcha.com：(By.CSS_SELECTOR, 'iframe[src*="hcaptcha.com"]')
• 通过专属data属性：(By.CSS_SELECTOR, 'iframe[data-hcaptcha-widget]')

步骤2：修改代码加入JS可见性检测

from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.common.by import By

# 原有点击提交按钮的代码
submit_button = wait.until(EC.visibility_of_element_located((By.CSS_SELECTOR, 'button[data-testid="btn-signup-submit"]')))
driver.execute_script("arguments[0].scrollIntoView();", submit_button)
submit_button.click()

wait = WebDriverWait(driver, 30)
# 精准定位hCaptcha iframe
iframe_locator = (By.CSS_SELECTOR, 'iframe[src*="hcaptcha.com"]')
# 先等待iframe存在于DOM
iframe = wait.until(EC.presence_of_element_located(iframe_locator))

# 自定义JS判断可见性：检查样式、尺寸、视口位置
wait.until(lambda d: d.execute_script("""
    const el = arguments[0];
    const style = window.getComputedStyle(el);
    const rect = el.getBoundingClientRect();
    // 核心判断：元素不隐藏、有实际尺寸、且至少部分在视口内
    return (
        style.display !== 'none' &&
        style.visibility !== 'hidden' &&
        style.opacity !== '0' &&
        rect.width > 0 &&
        rect.height > 0 &&
        rect.top < window.innerHeight && rect.bottom > 0 &&
        rect.left < window.innerWidth && rect.right > 0
    );
""", iframe))

# 确认可见后再切换到iframe
driver.switch_to.frame(iframe)
print('captcha frame visible')

额外说明 #

• 如果不需要检查视口内显示，可去掉最后两行视口相关的判断，只保留样式和尺寸检查；
• 部分网站可能用父元素隐藏iframe，这时候JS判断依然有效，因为getComputedStyle会继承父元素的可见性属性。

内容的提问来源于stack exchange，提问作者creep dude