自动化测试 / 系统课时

断言文本内容

断言文本内容

本篇解决页面文本如何稳定校验的问题:既能检查完整文本,也能只检查关键片段,还能一次验证一组元素的文本和顺序。完成后,你可以用 toHaveText() 与 toContainText() 直接等待异步文本更新并完成断言。

学习目标

  • 使用 toHaveText() 验证完整文本或正则匹配
  • 使用 toContainText() 验证文本中的关键片段
  • 使用数组断言验证元素列表的内容、数量与顺序

区分完整文本与部分文本

toHaveText() 适合“最终文本应该是什么”这类确定性检查。传入字符串时,Playwright 会对实际值和期望值做空白规范化,再比较文本;也可以传入正则表达式处理动态但有规则的内容。

toContainText() 适合只关心关键片段的场景。例如提示语可能从“订单已完成”改成“订单已完成,可前往详情页”,只要业务要求是必须出现“已完成”,部分文本断言会更稳健。

用一个示例覆盖三种文本校验

下面的测试构造状态文本和步骤列表。状态会异步从“处理中”更新为“订单已完成”,toHaveText() 会自动等待变化完成,不需要固定睡眠。

ts
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。

预期输出

text
Running 1 test using 1 worker
✓  1 text.spec.ts:<ID> › 验证单个文本和文本列表
1 passed (<TIME>)

行号、测试编号和耗时可能不同。只要异步状态最终变为目标文本,并且三个列表项保持预期顺序,测试就会通过。

文本列表不是简单字符串拼接

当 Locator 匹配多个元素时,toHaveText([...]) 会逐项比较整个元素列表:实际元素数量必须与期望数组长度一致,并且按照相同顺序一一匹配。因此,它很适合导航菜单、步骤条或搜索结果等对数量和顺序都有要求的区域。

如果改用 toContainText([...]),数组语义更宽松:期望值只需按顺序出现在实际元素列表的某个子集中,不要求实际元素总数等于期望数组长度。需要精确验收完整列表时,优先使用 toHaveText([...])。

处理动态文本与空白

字符串断言会规范化空白字符,所以页面里多余空格或换行通常不会导致 toHaveText('订单已完成') 失败。若文本包含动态编号、数量或时间,可以使用正则表达式,例如 await expect(status).toHaveText(/^订单 #\d+ 已完成$/)。

文本断言应验证业务真正承诺的内容:精确文案用完整匹配,可变格式用正则,允许附加说明时用部分匹配,多元素区域则明确决定是否同时约束数量与顺序。

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

目录与阅读设置

阅读设置

17

记录一个想法

断言文本内容

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

登录哪都通