Selenium 默认无法直接访问 iframe 内部的 DOM 元素，必须先切换至目标 iframe 上下文才能定位其中的文本或元素；本文详解 iframe 切换机制、等待策略及完整实践代码。
selenium 默认无法直接访问 iframe 内部的 dom 元素，必须先切换至目标 iframe 上下文才能定位其中的文本或元素；本文详解 iframe 切换机制、等待策略及完整实践代码。
在使用 Selenium 进行网页自动化时，一个常见却容易被忽视的陷阱是：目标文本或元素实际位于 iframe（内联框架）中，而 WebDriver 默认仅操作顶层文档（top-level document）。若未显式切换上下文，所有 find_element、text_to_be_present_in_element 等操作均会在空的或不包含目标内容的父页面中执行，导致“明明页面上有，Selenium 就是找不到”。
以示例网址 https://www.bursamalaysia.com/... 为例，其公告详情实际通过
-
等待 iframe 加载就绪并切换进去
使用 EC.frame_to_be_available_and_switch_to_it() 确保 iframe 存在且可交互，再自动完成上下文切换； -
在 iframe 内执行目标断言或查找
此时所有定位操作（如 By.TAG_NAME, "body"）均作用于 iframe 的 DOM； -
操作完成后切回顶层文档（必要时）
调用 driver.switch_to.default_content() 恢复到主页面，避免后续操作因上下文错误而失败。
以下是修正后的完整可运行代码：
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
driver = webdriver.Chrome()
url = 'https://www.bursamalaysia.com/market_information/announcements/company_announcement/announcement_details?ann_id=3434107'
driver.get(url)
wait = WebDriverWait(driver, 10)
try:
# ✅ 关键步骤：等待 iframe 出现并切换至其中
wait.until(EC.frame_to_be_available_and_switch_to_it((By.ID, "bm_ann_detail_iframe")))
# ✅ 在 iframe 内查找文本（此时 body 指 iframe 的 body）
wait.until(EC.text_to_be_present_in_element((By.TAG_NAME, "body"), "Annual Audited Accounts"))
print("Found: Annual Audited Accounts")
# ? 后续操作示例：点击 PDF 链接（可根据实际 XPath 补充）
# pdf_link = driver.find_element(By.XPATH, "//a[contains(@href, '.pdf')]")
# pdf_link.click()
except TimeoutError:
print("❌ Timeout: Text 'Annual Audited Accounts' not found in iframe.")
except Exception as e:
print(f"❌ Unexpected error: {e}")
finally:
# ✅ 切回主文档（良好实践，尤其当需继续操作父页时）
driver.switch_to.default_content()
driver.quit()
⚠️ 注意事项：
- 不要省略 frame_to_be_available_and_switch_to_it 的显式等待——直接 switch_to.frame(...) 可能因 iframe 尚未加载而抛出 NoSuchFrameException；
- iframe 的定位方式不限于 By.ID，也可用 By.NAME、By.XPATH 或 WebElement 对象（如 driver.find_element(By.TAG_NAME, "iframe")）；
- 若页面含多层嵌套 iframe，需逐级 switch_to.frame()，并用 switch_to.parent_frame() 回退一级；
- 建议始终用 try/except/finally 包裹，并在 finally 中调用 default_content() 和 quit()，确保资源释放与上下文安全。
掌握 iframe 切换是 Selenium 高级定位的基石。一旦识别出内容位于 iframe 中，问题便迎刃而解——这并非 Selenium 的缺陷，而是 Web 标准对沙箱隔离的必然要求。
