自动化测试 / 系统课时
提交表单
提交表单
表单自动化不只是把字段填满再点按钮,还要确认提交动作真的触发了页面或业务状态变化。本课用 Selenium 4.x 的 Python API 完成一次真实表单提交,并用显式等待验证结果,避免把“点击成功”误判成“提交成功”。
学习目标
- 使用
send_keys()填写字段并通过提交按钮触发表单。 - 用显式等待验证提交后的页面结果,而不是依赖固定延时。
- 区分按钮点击、
submit()与业务成功三个不同层次。
用点击完成真实提交
浏览器测试应优先执行用户真正会做的动作:填写字段后点击提交按钮。当前 Selenium Python API 仍提供 WebElement.submit(),但它直接从表单元素触发提交,不会等价执行提交按钮上的点击处理逻辑;如果页面在按钮 click 事件里做校验、埋点或状态更新,测试就可能绕过真实路径。
下面示例使用 Selenium 官方测试页。脚本输入 Selenium,点击按钮,然后等待结果元素出现并断言文本。WebDriverWait 的 10 秒是最长等待时间,条件提前满足会立即继续。
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.support.ui import WebDriverWait
driver = webdriver.Chrome()
try:
driver.get("https://www.selenium.dev/selenium/web/web-form.html")
wait = WebDriverWait(driver, 10)
text_box = wait.until(
EC.element_to_be_clickable((By.NAME, "my-text"))
)
text_box.send_keys("Selenium")
submit_button = driver.find_element(By.CSS_SELECTOR, "button")
submit_button.click()
message = wait.until(
EC.visibility_of_element_located((By.ID, "message"))
)
assert message.text == "Received!"
print(message.text)
finally:
driver.quit()预期输出:
Received!等待提交后的可观察变化
点击动作返回只代表 WebDriver 已执行点击,不代表后端请求、页面跳转或前端渲染已经完成。提交后应等待“业务上可观察”的变化,通常从下面三类信号中选一个,超时时间可先用 5~10 秒,再按系统真实响应上限调整。
| 提交结果 | 推荐等待条件 | 适用场景 |
|---|---|---|
| 跳转到新地址 | EC.url_contains("/success") 或 EC.url_changes(old_url) |
传统表单提交、登录跳转 |
| 页面出现结果文本 | EC.visibility_of_element_located(...) |
提交后展示成功提示 |
| 原表单被替换 | EC.staleness_of(old_form) |
SPA 重渲染或整块 DOM 更新 |
不要把 time.sleep(3) 当作提交验证。页面 0.5 秒完成时它浪费时间,页面 4 秒完成时它又会偶发失败。显式等待把同步条件写成测试的一部分,失败时也更容易定位到底缺少哪个结果。
判断提交是否真正成功
验证条件要贴近业务结果,而不是只看按钮是否可点击。注册表单可以检查成功提示或新用户标识,登录表单可以检查跳转后的账户区域,编辑表单则应检查保存后的字段值或接口驱动的页面状态。
一个实用的检查顺序是:先确认提交前输入值正确,再执行点击;随后等待页面发生预期变化;最后读取变化后的元素并做断言。若页面只是显示“已提交”但数据并未保存,还应在后续页面重新读取该数据,避免只验证前端提示。
处理常见失败
遇到 ElementClickInterceptedException 时,先检查是否有遮罩、弹窗或加载层挡住按钮,并等待遮挡元素消失;不要第一时间改成 JavaScript 强制点击。若按钮在字段合法前保持禁用,应先断言 is_enabled(),再检查必填项、格式校验和前置选择是否完成。
如果点击后一直等不到结果,按“浏览器是否触发提交 → 页面是否导航或重渲染 → 目标结果元素是否真的存在”排查。定位器应指向稳定属性,例如 id、name 或业务定义的测试属性,避免依赖会随样式调整变化的深层 CSS 路径。