如何通过Selenium强制Shadow Root为Open以访问iframe内的ReCaptcha元素

核心思路 #

要在iframe内容开始加载前注入脚本，覆盖Element.prototype.attachShadow方法，强制所有后续创建的Shadow Root为open模式。这样iframe内组件创建Shadow Root时会自动变为可访问的open类型，之后就能通过shadowRoot属性直接获取内部元素。

具体实现步骤 #

1. 提前通过CDP注入全局脚本
   利用Selenium调用Chrome DevTools协议（CDP）的Page.addScriptToEvaluateOnNewDocument接口，这个接口会在任何新文档（包括iframe）加载时自动执行注入的脚本，确保脚本在iframe初始化前生效。

   Python代码示例：

   from selenium import webdriver
   from selenium.webdriver.chrome.options import Options
   from selenium.webdriver.common.by import By
   
   chrome_options = Options()
   driver = webdriver.Chrome(options=chrome_options)
   
   # 编写覆盖attachShadow的脚本
   inject_script = """
   Element.prototype._originalAttachShadow = Element.prototype.attachShadow;
   Element.prototype.attachShadow = function(options) {
       options.mode = 'open';
       return this._originalAttachShadow(options);
   };
   """
   
   # 通过CDP注入脚本，作用于所有新加载的文档（含iframe）
   driver.execute_cdp_cmd(
       "Page.addScriptToEvaluateOnNewDocument",
       {"source": inject_script}
   )
   
   # 加载目标页面，此时iframe加载时脚本会自动运行
   driver.get("你的目标页面URL")
   

2. 切换到iframe并访问Shadow Root内元素
   当iframe加载完成后，切换到iframe上下文，直接通过元素的shadow_root属性获取内部DOM，再定位目标按钮：

   # 定位并切换到验证码iframe（根据实际页面调整选择器）
   captcha_iframe = driver.find_element(By.CSS_SELECTOR, "iframe[src*='recaptcha']")
   driver.switch_to.frame(captcha_iframe)
   
   # 找到包含Shadow Root的宿主元素
   shadow_host = driver.find_element(By.CSS_SELECTOR, "你的Shadow Host元素选择器")
   # 此时shadow_root已变为可访问状态
   shadow_root = shadow_host.shadow_root
   
   # 在Shadow Root内定位并点击目标按钮
   target_button = shadow_root.find_element(By.CSS_SELECTOR, "你的按钮选择器")
   target_button.click()
   
   # 切换回主文档（按需执行）
   driver.switch_to.default_content()
   

关键注意事项 #

• 注入时机必须优先于iframe加载：如果目标页面打开后再注入脚本，已加载完成的iframe不会受影响，脚本仅对后续创建的元素生效。
• 脚本无破坏性：保留了原attachShadow方法的引用，仅强制修改mode参数，不会破坏页面原有功能。
• CDP命令覆盖范围：Page.addScriptToEvaluateOnNewDocument默认作用于所有新创建的浏览上下文，无需额外配置即可覆盖iframe。

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