Selenium中Chrome窗口失焦时无法识别元素问题求助

针对窗口失焦无法获取元素的解决方案 #

• 避免依赖屏幕坐标的定位方式，改用元素的固有属性（如XPath、CSS选择器、ID、class）定位，这些属性不受窗口焦点状态影响。示例：

  from selenium.webdriver.common.by import By
  element = driver.find_element(By.XPATH, "//div[@data-testid='conversation-search-input']")
  

• 操作前强制将WhatsApp窗口前置并聚焦，用自动化工具API实现：

  # 切换到WhatsApp所在窗口
  driver.switch_to.window(driver.window_handles[0])
  # 执行JS强制窗口聚焦
  driver.execute_script("window.focus();")
  

• 针对失焦时动态隐藏的元素，使用显式等待确保元素可见后再操作：

  from selenium.webdriver.support.ui import WebDriverWait
  from selenium.webdriver.support import expected_conditions as EC
  
  wait = WebDriverWait(driver, 15)
  target_element = wait.until(EC.visibility_of_element_located((By.CSS_SELECTOR, ".target-class")))
  

针对无头模式完全无法识别元素的解决方案 #

• 配置无头浏览器的视口大小，避免元素因视口过小被隐藏：

  from selenium import webdriver
  from selenium.webdriver.chrome.options import Options
  
  chrome_options = Options()
  chrome_options.add_argument("--headless=new")
  chrome_options.add_argument("--window-size=1920,1080")  # 设置和正常浏览器一致的视口
  driver = webdriver.Chrome(options=chrome_options)
  

• 模拟正常浏览器的User-Agent，绕过网站的无头模式检测：

  chrome_options.add_argument("user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36")
  

• 禁用自动化特征检测，避免网站拦截无头浏览器：

  chrome_options.add_argument("--disable-blink-features=AutomationControlled")
  chrome_options.add_experimental_option("excludeSwitches", ["enable-automation"])
  chrome_options.add_experimental_option('useAutomationExtension', False)
  

• 增加页面加载等待时间，确保页面完全渲染完成再定位元素：

  driver.get("https://web.whatsapp.com/")
  # 等待页面加载完成
  WebDriverWait(driver, 20).until(lambda d: d.execute_script('return document.readyState') == 'complete')
  

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