iframe 处理详解

Selenium —— iframe 处理详解（高频踩坑点）

1. 原理说明

HTML 中 <iframe> 可以嵌入另外一个独立网页，iframe 内部的元素，属于另一个文档

默认情况下 driver 只能定位【外层主页面】元素
❌ 直接定位iframe里面元素 → 超时找不到元素报错
✅ 必须先切换进入 iframe，才能操作内部元素；操作完切回主文档

2. 切换 iframe 的三种方式

语法：driver.switch_to.frame(参数)

1. 根据 iframe下标（从0开始，页面第1个iframe=0）

web_driver.switch_to.frame(0)

2. 根据 id / name 属性

web_driver.switch_to.frame("iframe_id")

3. 先定位iframe元素对象，再传入（最常用！推荐）

iframe_ele = wait.until(EC.presence_of_element_located((By.XPATH, "//iframe[@class='demo']")))
web_driver.switch_to.frame(iframe_ele)

3. 重点：切回主页面（必记！）

操作完iframe里面元素之后，如果还要操作外层页面，一定要切回去

# 切回顶层主文档
web_driver.switch_to.default_content()

# 补充：多层嵌套iframe，返回上一层父iframe
web_driver.switch_to.parent_frame()

4. 完整标准模板（结合显式等待，企业写法）

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

web_driver = webdriver.Edge(service=Service(r"D:\Software\edgedriver_win64\msedgedriver.exe"))
wait = WebDriverWait(web_driver, 10)
web_driver.get("测试网页地址")

# 1. 等待iframe加载，定位iframe元素
iframe = wait.until(EC.presence_of_element_located((By.XPATH, "//iframe")))
# 2. 切换进入iframe
web_driver.switch_to.frame(iframe)

# ========== 这里操作iframe内部元素 ==========
input_ele = wait.until(EC.visibility_of_element_located((By.ID, "username")))
input_ele.send_keys("test")
# =========================================

# 3. 切回主页面！！
web_driver.switch_to.default_content()

# 继续操作外层页面元素...

web_driver.quit()

5. 常见坑总结

1. 忘记切换frame → 元素找不到
2. 操作完iframe，忘记切回主文档，后续外层元素全部定位失败
3. 多层iframe嵌套：需要一层一层切换进去，不要直接跳
4. iframe是动态加载的：必须配合显式等待iframe出现，不能直接switch

📝 课堂练习需求

模拟场景：页面存在一个iframe，iframe里面有账号输入框
编写代码：

1. 打开测试页面
2. 等待iframe加载完成，切换进入iframe
3. 在iframe内输入账号 admin
4. 切换回顶层主页面
5. 关闭浏览器

拓展小思考题：
如果页面有两层嵌套 iframe（A里面包含B），如何切换到B里面操作？操作完成如何回到最外层主页面？

补充：网上很多免费iframe测试页面，这个可以直接运行测试的网址：
https://www.w3schools.com/html/tryit.asp?filename=tryhtml_iframe