自动化测试 / 系统课时
断言文本内容
断言文本内容
本篇解决页面文本如何稳定校验的问题:既能检查完整文本,也能只检查关键片段,还能一次验证一组元素的文本和顺序。完成后,你可以用 toHaveText() 与 toContainText() 直接等待异步文本更新并完成断言。
学习目标
- 使用
toHaveText()验证完整文本或正则匹配 - 使用
toContainText()验证文本中的关键片段 - 使用数组断言验证元素列表的内容、数量与顺序
区分完整文本与部分文本
toHaveText() 适合“最终文本应该是什么”这类确定性检查。传入字符串时,Playwright 会对实际值和期望值做空白规范化,再比较文本;也可以传入正则表达式处理动态但有规则的内容。
toContainText() 适合只关心关键片段的场景。例如提示语可能从“订单已完成”改成“订单已完成,可前往详情页”,只要业务要求是必须出现“已完成”,部分文本断言会更稳健。
用一个示例覆盖三种文本校验
下面的测试构造状态文本和步骤列表。状态会异步从“处理中”更新为“订单已完成”,toHaveText() 会自动等待变化完成,不需要固定睡眠。
import { test, expect } from '@playwright/test';
test('验证单个文本和文本列表', async ({ page }) => {
await page.setContent(`
<p data-testid="status">处理中</p>
<ul id="steps">
<li>创建订单</li>
<li>支付成功</li>
<li>发送通知</li>
</ul>
<script>
setTimeout(() => {
document.querySelector('[data-testid="status"]').textContent = '订单已完成';
}, 100);
</script>
`);
const status = page.getByTestId('status');
const steps = page.locator('#steps > li');
// 完整文本:等待异步更新后的最终值。
await expect(status).toHaveText('订单已完成');
// 部分文本:只要求实际文本包含关键内容。
await expect(status).toContainText('已完成');
// 文本列表:元素数量、顺序和每一项文本都必须匹配。
await expect(steps).toHaveText(['创建订单', '支付成功', '发送通知']);
});将文件保存为 text.spec.ts 后运行 npx playwright test text.spec.ts。
预期输出
Running 1 test using 1 worker
✓ 1 text.spec.ts:<ID> › 验证单个文本和文本列表
1 passed (<TIME>)行号、测试编号和耗时可能不同。只要异步状态最终变为目标文本,并且三个列表项保持预期顺序,测试就会通过。
文本列表不是简单字符串拼接
当 Locator 匹配多个元素时,toHaveText([...]) 会逐项比较整个元素列表:实际元素数量必须与期望数组长度一致,并且按照相同顺序一一匹配。因此,它很适合导航菜单、步骤条或搜索结果等对数量和顺序都有要求的区域。
如果改用 toContainText([...]),数组语义更宽松:期望值只需按顺序出现在实际元素列表的某个子集中,不要求实际元素总数等于期望数组长度。需要精确验收完整列表时,优先使用 toHaveText([...])。
处理动态文本与空白
字符串断言会规范化空白字符,所以页面里多余空格或换行通常不会导致 toHaveText('订单已完成') 失败。若文本包含动态编号、数量或时间,可以使用正则表达式,例如 await expect(status).toHaveText(/^订单 #\d+ 已完成$/)。
文本断言应验证业务真正承诺的内容:精确文案用完整匹配,可变格式用正则,允许附加说明时用部分匹配,多元素区域则明确决定是否同时约束数量与顺序。