自动化测试 / 系统课时
断言输入值与属性
断言输入值与属性
表单测试不能只确认元素“存在”,还要确认用户真正看到的输入值、元素属性和 CSS 类名是否处于正确状态。本节用 Playwright 的 Web-first 断言验证这些状态,并利用自动等待避免手动轮询和不稳定的固定延时。
学习目标
- 使用
toHaveValue()验证输入框当前值 - 使用
toHaveAttribute()验证元素属性 - 使用
toHaveClass()稳定检查 CSS 类名
输入值与 DOM 属性不是一回事
toHaveValue() 读取表单控件当前值,适合 input、textarea 和 select 等可编辑控件。它验证的是用户操作后的实时值,因此比只检查初始 HTML 中的 value 属性更贴近真实交互结果。
toHaveAttribute() 则检查元素的 DOM 属性,例如 type、aria-required、data-*。当页面通过脚本稍后补充属性时,Playwright 会在断言超时前持续重试,而不是在第一次读取失败后立刻结束测试。
用一个测试覆盖值、属性和类名
下面的测试通过 page.setContent() 构造确定性的表单状态,不依赖外部网站,可直接放入 input-assertions.spec.ts。
import { test, expect } from '@playwright/test';
test('assert input value and attributes', async ({ page }) => {
await page.setContent(`
<label>
Email
<input
id="email"
class="field field--valid"
type="email"
value="alice@example.com"
aria-required="true"
>
</label>
`);
const email = page.locator('#email');
// 值断言面向用户当前看到的表单状态。
await expect(email).toHaveValue('alice@example.com');
// 属性和类名断言用于验证组件结构与状态标记。
await expect(email).toHaveAttribute('type', 'email');
await expect(email).toHaveAttribute('aria-required', 'true');
await expect(email).toHaveClass(/(^|\s)field--valid(\s|$)/);
});运行测试:
npx playwright test input-assertions.spec.ts预期输出的关键结果:
Running 1 test using 1 worker
1 passed (<TIME>)实际耗时和输出细节可能因 Playwright 版本与机器性能不同。
类名断言要避免顺序陷阱
当 toHaveClass() 接收完整字符串时,它适合验证整个 class 属性;但组件往往会同时拥有多个类,而且类的顺序可能变化。只关心某个状态类时,用正则表达式匹配单个类名更稳妥。
例如示例中的正则同时约束类名前后的空白或字符串边界,避免把 field--valid-extra 误判为 field--valid。如果业务确实要求完整类集合固定,再使用完整字符串进行严格断言。
失败时先看“实际值”
断言失败时,Playwright 会展示期望值与实际值。若 toHaveValue() 失败,先确认页面是否真的完成了输入或数据回填;若属性失败,再检查定位器是否指向了正确元素,以及属性是否在异步渲染后才出现。
输入值、属性和类名分别代表不同层次的页面状态:值体现用户输入结果,属性体现元素语义或配置,类名常用于组件状态。选择与需求最接近的断言,测试会比笼统检查元素存在更有价值。