Web 自动化测试常用函数解析与场景应用

2.2 文本输入与清除：模拟用户输入

• 输入文本：send_keys("内容") 函数可模拟键盘输入，例如向百度搜索框输入'迪丽热巴'，代码为 driver.find_element(By.CSS_SELECTOR, "#kw").send_keys("迪丽热巴")；

driver.find_element(By.CSS_SELECTOR, "#kw").send_keys("迪丽热巴")

• 清除文本：若需要更换输入内容，需先用 clear() 函数清空原有文本，再执行新的输入——比如先输入'迪丽热巴'，1 秒后清空并输入'古力娜扎'，完整代码需结合 time.sleep() 控制时序

driver.find_element(By.CSS_SELECTOR, "#kw").send_keys("迪丽热巴")
time.sleep(1)
driver.find_element(By.CSS_SELECTOR, "#kw").clear()
time.sleep(1)
driver.find_element(By.CSS_SELECTOR, "#kw").send_keys("古力娜扎")

2.3 文本与属性获取：验证测试结果

自动化测试中，常需要获取元素文本或属性值来验证结果是否符合预期：

• 获取文本：通过 text 属性获取元素可见文本，例如获取百度热搜第一个标签的文本，代码为 text = driver.find_element(By.XPATH, '//*[@id="hotsearch-content-wrapper"]/li[1]/a/span[2]').text；

text = driver.find_element(By.XPATH, '//*[@id="hotsearch-contentwrapper"]/li[1]/a/span[2]').text
print(f"text:{text}")

• 获取属性：通过 get_attribute("属性名称") 函数获取元素属性值——比如获取按钮的'value'属性、链接的'href'属性，需注意区分'文本'和'属性值'，避免混淆；

title = driver.title

• 页面信息获取：driver.title 可获取当前页面标题，driver.current_url 可获取当前页面 URL，常用于验证页面跳转是否正确。

url = driver.current_url

三、窗口与弹窗控制：解决'多窗口与弹窗干扰'

自动化测试中，多窗口切换、弹窗弹出是常见场景，若不处理会导致脚本'迷路'或元素定位失败，文档中提供了完整的控制方案。

3.1 窗口控制：句柄是关键

每个浏览器窗口都有唯一的'句柄（handle）'，程序通过句柄识别和切换窗口：

• 获取句柄：driver.current_window_handle 获取当前窗口句柄，driver.window_handles 获取所有打开窗口的句柄列表；
• 切换窗口：遍历所有句柄，找到与当前句柄不同的新句柄，通过 driver.switch_to.window(window) 切换到新窗口，适用于点击链接打开新页面的场景；

curWindow = driver.current_window_handle
allWindows = driver.window_handles
for window in allWindows:
    if window != curWindow:
        driver.switch_to.window(window)

• 窗口大小与截图：driver.maximize_window()（最大化）、driver.minimize_window()（最小化）可控制窗口大小；driver.save_screenshot("路径") 能截取当前屏幕，用于报错时记录现场；——高阶用法可结合时间戳生成唯一文件名，避免截图覆盖。

# 窗口最大化
driver.maximize_window()
# 窗口最小化
driver.minimize_window()
# 窗口全屏
driver.fullscreen_window()
# 手动设置窗口大小
driver.set_window_size(1024, 768)
# 关闭窗口
driver.close()  # 注意：窗口关闭后 driver 要重新定义

driver.save_screenshot('../images/image.png')  # 简单版本
driver.save_screenshot('../images/image.png')  # 高阶版本
filename = "autotest-" + datetime.datetime.now().strftime('%Y-%m-%d-%H%M%S') + '.png'
driver.save_screenshot('../images/' + filename)

3.2 弹窗处理：Alert 接口来应对

页面弹窗（警告弹窗、确认弹窗、提示弹窗）无法通过常规元素定位找到，需使用 Selenium 提供的 Alert 接口：

警告 / 确认弹窗：通过 driver.switchTo.alert 切换到弹窗，alert.accept() 点击'确定'，alert.dismiss() 点击'取消'；

alert = driver.switchTo.alert
# 确认
alert.accept()
# 取消
alert.dismiss()

• 提示弹窗：除了'确定 / 取消'，还需输入文本，可通过 alert.send_keys("内容") 输入，再执行确认操作。

alert = driver.switchTo.alert
alert.send_keys("hello")
alert.accept()
alert.dismiss()

四、等待机制：避免'代码快于页面渲染'

代码执行速度远快于页面渲染速度，若不设置等待，程序可能在元素未加载时就执行操作，导致'元素找不到'的误报。文档中介绍了三种等待方式，各有适用场景。

4.1 强制等待：简单但低效

• 函数：time.sleep(秒数)，强制让代码暂停指定时间，等待页面加载；
• 优缺点：优点是使用简单，适合调试；缺点是固定等待时间，若页面提前加载完成，会浪费时间；若页面加载超时，仍会报错。

4.2 隐式等待：全局智能等待

• 函数：driver.implicitly_wait(秒数)，设置全局等待时间，在指定时间内不断查找元素，找到则继续执行，超时未找到则报错；
• 特点：作用域覆盖整个脚本，只要 driver 对象未释放（未执行 driver.quit()），等待就一直生效，无需重复设置。

4.3 显示等待：灵活的条件等待

• 函数：WebDriverWait(driver, 秒数).until(条件)，在指定时间内等待'条件满足'，满足则继续执行，超时则报错；
• 常用条件：依赖 ExpectedConditions 类，例如 EC.presence_of_element_located(locator)（元素存在于 DOM 中）、EC.visibility_of_element_located(locator)（元素可见）、EC.alert_is_present()（弹窗出现）等；
• 优缺点：优点是可自定义等待条件，灵活性高；缺点是写法复杂，需导入相关包。

from selenium.webdriver.support import expected_conditions as EC
wait = WebDriverWait(driver, 2)
wait.until(EC.invisibility_of_element((By.XPATH, '//*[@id="2"]/div/div/div[3]/div[1]/div[1]/div')))

关键提醒： 隐式等待和显示等待不能混合使用！文档中的实验表明，设置 10 秒隐式等待 + 15 秒显示等待，最终会导致 20 秒后才超时，出现不可预测的等待时间。

# 隐式等待设置为 10s，显示等待设置为 15s，那么结果会是 5+10=15s 吗？
driver.implicitly_wait(10)
wait = WebDriverWait(driver, 15)
start = time.time()
try:
    res = wait.until(EC.presence_of_element_located((By.XPATH, '//*[@id="2"]/div/div/div[3]/div[1]/div[1]/div/div/div')))
except:
    end = time.time()
    print("no such element")
    driver.quit()
print(end-start)

五、其他实用功能：浏览器导航与文件上传

除了核心模块，文档还补充了浏览器导航和文件上传的常用函数，覆盖更多测试场景。

5.1 浏览器导航：模拟前进 / 后退 / 刷新

• 打开网站：driver.get("URL")，例如 driver.get("https://tool.lu/")；

driver.get("https://tool.lu/")

• 前进 / 后退 / 刷新：driver.forward()（前进）、driver.back()（后退）、driver.refresh()（刷新），适用于需要在多个页面间切换的测试场景。

driver.back()
driver.forward()
driver.refresh()

5.2 文件上传：绕开系统弹窗

Selenium 无法识别系统自带的文件上传窗口，但可通过 send_keys 函数直接传入文件路径，间接实现上传：

• 步骤：定位文件上传的 input 元素（类型为 file），调用 send_keys("文件路径")，例如 ele.send_keys("D:\\file\\test.txt")；

driver.get("file:///D:/file/%E6%AF%94%E7%89%B9%E6%95%99%E5%8A%A1/%E6%B5%8B%E8%A F%95/selenium4html/selenium-html/upload.html")
ele = driver.find_element(By.CSS_SELECTOR, "body > div > div > input[type=file]")
ele.send_keys("D:\\file\\test.txt")

• 注意：文件路径需使用绝对路径，Windows 系统中路径分隔符需用 \\（转义）或 /。

六、浏览器参数设置：定制化测试环境

浏览器参数设置是自动化测试的'前置配置'，通过自定义参数可模拟不同设备、禁用弹窗、设置代理等，解决特殊场景下的测试需求。以下是自动化中常用的浏览器参数配置方法：

6.1 设置无头模式：无界面运行，适用于服务器环境

options = webdriver.ChromeOptions()
options.add_argument("-headless")
driver = webdriver.Chrome(service=ChromeService(ChromeDriverManager().install()), options=options)

6.2 页面加载策略

options.page_load_strategy = '加载方式'

页面加载方式主要有三种类型：

options = webdriver.ChromeOptions()
options.page_load_strategy = 'eager'
driver = webdriver.Chrome(service=ChromeService(ChromeDriverManager().install()), options=options)

结语

本文系统梳理了 Web 自动化测试中的核心函数与实战技巧——从元素定位的'精准导航'，到测试对象的'动作执行'，再到窗口、弹窗、等待的'异常处理'，每个模块都对应实际测试中的高频场景。掌握这些函数不仅能解决'元素找不到''操作时序错'等基础问题，更能帮助我们编写稳定、高效的自动化脚本。需要注意的是，自动化测试并非'函数堆砌'，而是需要结合具体业务场景灵活选择工具：例如定位优先用 cssSelector（高效），复杂场景用 xpath（灵活）；等待优先用显示等待（精准），简单场景用隐式等待（便捷）。只有将函数与场景深度结合，才能充分发挥自动化测试的价值，提升测试效率与质量。