自动化测试 / 系统课时

提交表单

提交表单

表单自动化不只是把字段填满再点按钮,还要确认提交动作真的触发了页面或业务状态变化。本课用 Selenium 4.x 的 Python API 完成一次真实表单提交,并用显式等待验证结果,避免把“点击成功”误判成“提交成功”。

学习目标

  • 使用 send_keys() 填写字段并通过提交按钮触发表单。
  • 用显式等待验证提交后的页面结果,而不是依赖固定延时。
  • 区分按钮点击、submit() 与业务成功三个不同层次。

用点击完成真实提交

浏览器测试应优先执行用户真正会做的动作:填写字段后点击提交按钮。当前 Selenium Python API 仍提供 WebElement.submit(),但它直接从表单元素触发提交,不会等价执行提交按钮上的点击处理逻辑;如果页面在按钮 click 事件里做校验、埋点或状态更新,测试就可能绕过真实路径。

下面示例使用 Selenium 官方测试页。脚本输入 Selenium,点击按钮,然后等待结果元素出现并断言文本。WebDriverWait 的 10 秒是最长等待时间,条件提前满足会立即继续。

python
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()

预期输出:

text
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 路径。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

提交表单

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通