自动化测试 / 系统课时
输入与清空文本
输入与清空文本
文本输入测试最常见的错误,是只调用 send_keys() 却不确认原值、焦点和提交结果。本节用 Selenium Python 4.x 完成“读取原值、清空、输入、按 Enter、验证 DOM 状态”的完整流程,并说明组合键和不可编辑控件的边界。
学习目标
- 使用
clear()清除文本框原值,并用send_keys()输入新内容。 - 使用
Keys模拟 Enter、Tab 等真实键盘按键。 - 读取输入框的 DOM 属性并验证页面接收到的最终文本。
选择与控件匹配的输入方法
普通 input、textarea 和可编辑区域可通过 send_keys() 接收键盘输入;文本输入框需要清除旧值时,优先使用 clear()。验证当前文本时,读取 value DOM property 比读取最初写在 HTML 里的属性更准确。
| 需求 | 推荐做法 | 验证方式 |
|---|---|---|
| 清除已有文本 | field.clear() |
field.get_property('value') == '' |
| 输入字符串 | field.send_keys('selenium') |
检查 value |
| 按 Enter | field.send_keys(Keys.ENTER) |
检查提交结果或页面变化 |
| 切换焦点 | field.send_keys(Keys.TAB) |
检查 driver.switch_to.active_element |
不要把 send_keys() 当成直接修改 DOM 值。它模拟的是键盘输入,因此更容易触发页面的 keydown、input 等真实交互逻辑,适合验证前端表单是否按用户操作工作。
完成清空、输入和 Enter 提交
下面构造一个带初始值的输入框。脚本先读取旧值,再清空并输入新内容,最后发送 Enter;页面监听 Enter 后把当前文本写入结果区域,因此可以同时验证输入值与提交行为。
from urllib.parse import quote
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.common.keys import Keys
html = '''
<!doctype html>
<meta charset='utf-8'>
<label>关键词 <input id='query' value='old value'></label>
<p id='submitted'></p>
<script>
const input = document.getElementById('query');
input.addEventListener('keydown', event => {
if (event.key === 'Enter') {
document.getElementById('submitted').textContent = input.value;
}
});
</script>
'''
driver = webdriver.Chrome()
try:
driver.get('data:text/html;charset=utf-8,' + quote(html))
field = driver.find_element(By.ID, 'query')
print('before=' + str(field.get_property('value')))
field.clear()
print('after_clear=' + str(field.get_property('value')))
field.send_keys('selenium webdriver')
field.send_keys(Keys.ENTER)
print('after_type=' + str(field.get_property('value')))
print('submitted=' + driver.find_element(By.ID, 'submitted').text)
finally:
driver.quit()预期输出:
before=old value
after_clear=
after_type=selenium webdriver
submitted=selenium webdriver这里用 get_property('value') 读取浏览器当前的 DOM property;它反映用户输入后的实时值。若要读取元素 attribute 层的精确值,应使用 get_dom_attribute();用户编辑后的实时文本通常应读取 value property,两者不要混为一谈。
模拟按键与组合键
单键操作直接使用 Keys.ENTER、Keys.TAB、Keys.ESCAPE 等常量。例如输入搜索词后发送 Keys.ENTER,通常比调用页面私有 JavaScript 函数更接近真实用户行为。
需要全选文本时,Windows 与 Linux 常用 field.send_keys(Keys.CONTROL, 'a'),macOS 通常改用 Keys.COMMAND。随后发送 Keys.BACKSPACE 可模拟人工清空;但对标准文本框,测试意图只是“清空原值”时优先使用 clear(),表达更直接。
输入失败时检查可编辑状态
如果元素带 disabled、readonly,或定位到的只是包裹输入框的外层 div,clear() 或 send_keys() 就可能失败。先检查定位器是否指向实际输入节点,再确认 is_enabled()、readonly 属性和页面是否已完成渲染。
前端框架重绘输入组件后,旧引用还可能触发 StaleElementReferenceException。这类情况应重新定位元素,再执行输入;不要为了绕过失败直接用 JavaScript 给 value 赋值,否则页面依赖的键盘或输入事件可能没有发生。
最终验收至少检查两层:输入框的 value 与预期字符串一致,以及按 Enter、Tab 等动作引发的页面结果正确。只检查“调用没有报错”无法证明表单真的接收并处理了输入。