自动化测试 / 系统课时
填写文本输入框
填写文本输入框
文本输入并不只有一种操作:多数表单适合直接设置值,依赖逐字符键盘事件的控件则需要模拟连续按键,而清空已有内容最好表达为明确的清除动作。本课用一个可运行示例对比 fill()、pressSequentially() 和 clear()。
学习目标
- 根据表单行为选择
fill()、pressSequentially()或clear() - 理解直接设置值与逐字符键盘事件的差异
- 使用断言验证输入框最终值和事件行为
先选对输入方法
fill() 是常规文本输入的首选,它会等待输入控件满足相应可操作条件,聚焦控件并设置完整值。clear() 专门清空输入内容,语义比 fill('') 更直观。只有页面依赖逐字符的键盘事件时,才使用 pressSequentially()。
| 方法 | 主要行为 | 典型场景 |
|---|---|---|
fill('text') |
用目标文本替换当前值 | 登录、搜索、普通表单 |
clear() |
清空当前值 | 重置输入后重新填写 |
pressSequentially('text') |
逐字符触发键盘与输入事件 | 自动补全、按键级校验、特殊键盘监听 |
pressSequentially() 不会自动清空旧值,它从当前光标位置继续输入;要发送 Enter、ArrowDown 等特殊键,应使用 press()。
用一个表单验证三种操作
下面的页面会统计 input 事件次数。fill() 设置完整值后产生一次输入事件,clear() 清空后再产生一次,而 pressSequentially('AI') 会为两个字符分别产生输入事件。
import { test, expect } from '@playwright/test';
test('fill、clear 与 pressSequentially 的行为不同', async ({ page }) => {
await page.setContent(`
<label>用户名 <input id="username"></label>
<output id="count">0</output>
<script>
const input = document.querySelector('#username');
const count = document.querySelector('#count');
input.addEventListener('input', () => {
count.textContent = String(Number(count.textContent) + 1);
});
</script>
`);
const input = page.getByLabel('用户名');
const count = page.locator('#count');
// 普通表单优先一次性设置完整值。
await input.fill('Play');
await expect(count).toHaveText('1');
await input.clear();
await expect(count).toHaveText('2');
// 需要逐字符事件时再模拟连续按键。
await input.pressSequentially('AI');
await expect(input).toHaveValue('AI');
await expect(count).toHaveText('4');
console.log(`value:${await input.inputValue()}`);
console.log(`input-events:${await count.textContent()}`);
});预期输出(关键控制台内容)
value:AI
input-events:4测试运行器还会输出用例状态和耗时等信息;这些动态信息不影响这里验证的输入值与事件次数。
理解 fill 与逐字符输入的边界
多数业务测试不需要模拟真实打字速度。fill() 更直接,也避免把测试时间浪费在字符间延迟上。只有组件把逻辑绑定到 keydown、keypress、逐次 input 等键盘过程,例如每输入一个字符就过滤候选项时,逐字符输入才有教学和测试价值。
如果确实需要观察每次按键后的页面变化,可以给 pressSequentially() 设置 delay。这个延迟应服务于控件行为,而不是为了“看起来更像真人”;能无延迟稳定工作的测试通常更快也更可靠。
清空和验证输入状态
fill() 会覆盖输入框当前内容,因此不需要先手动全选再删除。若测试步骤本身要表达“先清空再重新输入”,使用 clear() 更易读。对于禁用或只读字段,与其强行输入,不如先用断言确认它何时变为可编辑状态,再执行 fill()。
输入完成后应优先使用 toHaveValue() 验证最终值,而不是只检查操作没有抛错。这样既能发现定位到了错误输入框,也能发现前端格式化、校验或脚本把值意外改写的问题。