Selenium 默认无法直接访问 iframe 内部的 DOM 元素，若目标文本位于 iframe 中（如 Bursa Malaysia 公告页），必须先切换上下文至对应 iframe，再执行查找操作，否则始终返回“未找到”。
如何使用 selenium 正确查找嵌套在 iframe 中的网页文本内容 —— selenium 默认无法直接访问 iframe 内部的 dom 元素，若目标文本位于 iframe 中（如 bursa malaysia 公告页），必须先切换上下文至对应 iframe，再执行查找操作，否则始终返回“未找到”。
在 Web 自动化测试中，一个常见却容易被忽视的陷阱是：Selenium 的默认作用域仅限于顶层 HTML 文档（top-level document）。当页面包含 <iframe>（尤其是通过 src 动态加载内容的 iframe），其内部文档拥有独立的 DOM 树和 JavaScript 执行环境。此时，即使目标文本（例如 "Annual Audited Accounts"）在浏览器中肉眼可见，Selenium 若未主动切换至该 iframe 上下文，就无法定位其中任何元素或文本。
以您提供的 Bursa Malaysia 示例网址为例，关键内容实际渲染在 ID 为 bm_ann_detail_iframe 的 iframe 内。原始代码直接在主文档中搜索 "Annual Audited Accounts"，自然失败。
✅ 正确做法分三步：
- 等待 iframe 加载就绪并切换进去：使用 EC.frame_to_be_available_and_switch_to_it() 确保 iframe 可用且完成切换；
- 在 iframe 内执行文本查找：调用 EC.text_to_be_present_in_element() 检查其 body 是否包含目标文本；
- 操作完成后切回主文档（必要时）：调用 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:
# ✅ 关键步骤1：等待并切换至目标 iframe
wait.until(EC.frame_to_be_available_and_switch_to_it((By.ID, "bm_ann_detail_iframe")))
# ✅ 关键步骤2：在 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")
except TimeoutError:
print("❌ Timeout: Text not found in iframe within 10 seconds")
except Exception as e:
print(f"❌ Unexpected error: {e}")
finally:
# ✅ 关键步骤3：切回主文档（即使出错也应确保恢复上下文）
driver.switch_to.default_content()
driver.quit()⚠️ 注意事项：
- 勿省略 switch_to.default_content()：若后续还需操作主页面元素（如点击导航栏、关闭弹窗等），不切回会导致 NoSuchFrameException；
- iframe 定位方式灵活选择：除 By.ID 外，也可用 By.NAME、By.XPATH（如 //iframe[contains(@src,'announcement')])）或索引（driver.switch_to.frame(0)），但推荐语义化定位（ID/NAME）以增强健壮性；
- 避免隐式等待与显式等待混用：本例全程使用 WebDriverWait，更精准可控；若已设置 driver.implicitly_wait()，建议统一为显式等待；
- 调试技巧：可在切换 iframe 后添加 print(driver.page_source[:500]) 快速确认当前上下文内容。
掌握 iframe 上下文切换，是 Selenium 处理现代富交互网页（如银行系统、嵌入式 PDF 查看器、第三方评论组件）的必备技能。忽略它，90% 的“元素找不到”问题都将无解。
