自动化测试 / 系统课时

填写文本输入框

填写文本输入框

文本输入并不只有一种操作:多数表单适合直接设置值,依赖逐字符键盘事件的控件则需要模拟连续按键,而清空已有内容最好表达为明确的清除动作。本课用一个可运行示例对比 fill()、pressSequentially() 和 clear()。

学习目标

  • 根据表单行为选择 fill()、pressSequentially() 或 clear()
  • 理解直接设置值与逐字符键盘事件的差异
  • 使用断言验证输入框最终值和事件行为

先选对输入方法

fill() 是常规文本输入的首选,它会等待输入控件满足相应可操作条件,聚焦控件并设置完整值。clear() 专门清空输入内容,语义比 fill('') 更直观。只有页面依赖逐字符的键盘事件时,才使用 pressSequentially()。

方法 主要行为 典型场景
fill('text') 用目标文本替换当前值 登录、搜索、普通表单
clear() 清空当前值 重置输入后重新填写
pressSequentially('text') 逐字符触发键盘与输入事件 自动补全、按键级校验、特殊键盘监听

pressSequentially() 不会自动清空旧值,它从当前光标位置继续输入;要发送 Enter、ArrowDown 等特殊键,应使用 press()。

用一个表单验证三种操作

下面的页面会统计 input 事件次数。fill() 设置完整值后产生一次输入事件,clear() 清空后再产生一次,而 pressSequentially('AI') 会为两个字符分别产生输入事件。

ts
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()}`);
});

预期输出(关键控制台内容)

text
value:AI
input-events:4

测试运行器还会输出用例状态和耗时等信息;这些动态信息不影响这里验证的输入值与事件次数。

理解 fill 与逐字符输入的边界

多数业务测试不需要模拟真实打字速度。fill() 更直接,也避免把测试时间浪费在字符间延迟上。只有组件把逻辑绑定到 keydown、keypress、逐次 input 等键盘过程,例如每输入一个字符就过滤候选项时,逐字符输入才有教学和测试价值。

如果确实需要观察每次按键后的页面变化,可以给 pressSequentially() 设置 delay。这个延迟应服务于控件行为,而不是为了“看起来更像真人”;能无延迟稳定工作的测试通常更快也更可靠。

清空和验证输入状态

fill() 会覆盖输入框当前内容,因此不需要先手动全选再删除。若测试步骤本身要表达“先清空再重新输入”,使用 clear() 更易读。对于禁用或只读字段,与其强行输入,不如先用断言确认它何时变为可编辑状态,再执行 fill()。

输入完成后应优先使用 toHaveValue() 验证最终值,而不是只检查操作没有抛错。这样既能发现定位到了错误输入框,也能发现前端格式化、校验或脚本把值意外改写的问题。

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

目录与阅读设置

阅读设置

17

记录一个想法

填写文本输入框

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

登录哪都通