自动化测试 / 系统课时

断言元素数量

断言元素数量

列表、表格和搜索结果经常异步更新,数量断言不能只在某一瞬间读取 DOM。这里用 Playwright 的 toHaveCount() 对 Locator 做可重试的精确数量校验,并说明零结果、表格行与虚拟列表等常见边界。

学习目标

  • 使用 toHaveCount() 验证列表或搜索结果的元素数量
  • 理解数量断言为何能配合自动等待处理异步渲染
  • 避免因 Locator 范围过大或虚拟化渲染导致误判

用 toHaveCount 检查集合

Locator 可以匹配一组元素,await expect(locator).toHaveCount(n) 会反复重新检查匹配数量,直到等于目标值或断言超时。对于异步加载的列表,这比先调用 count() 再用普通数值断言更稳健,因为后者只读取调用当下的数量。

下面的测试先渲染空列表,稍后一次性插入 3 条搜索结果。断言开始时数量可能仍是 0,但会等待列表达到目标数量。

ts
import { test, expect } from '@playwright/test';

test('搜索结果最终出现 3 项', async ({ page }) => {
  await page.setContent(`
    <ul id="results"></ul>
    <script>
      setTimeout(() => {
        document.querySelector('#results').innerHTML = [
          '<li>Playwright</li>',
          '<li>TypeScript</li>',
          '<li>Testing</li>'
        ].join('');
      }, 300);
    </script>
  `);

  const items = page.locator('#results > li');

  // 数量断言会等待异步渲染完成,而不是只检查当前瞬间。
  await expect(items).toHaveCount(3);
  console.log(`result count: ${await items.count()}`);
});

预期输出:

text
result count: 3

测试通过意味着 Locator 最终恰好匹配 3 个元素;如果变成 2 个或 4 个,断言都会失败。

先缩小 Locator 再数数量

数量断言是否可信,首先取决于 Locator 的范围。表格通常应统计数据区中的行,而不是把表头也算进去;搜索页应限定结果容器,而不是统计页面上所有同类标签。

例如,目标是“结果列表中的卡片数”时,应优先使用类似 page.locator('[data-testid="results"] > article') 的局部定位。对表格数据行,可定位到 tbody > tr。这样页面导航栏、推荐区或隐藏模板中的同类元素不会污染数量。

不要把自动等待退化成瞬时读取

await items.count() 会返回调用时已经匹配到的数量,本身不是一个会持续等待“数量变成 3”的断言。因此,异步页面中不宜写成 expect(await items.count()).toBe(3) 来替代 await expect(items).toHaveCount(3)。

如果业务确实要求“此刻立即有几项”,直接读取 count() 是合理的;但只要目标是等待列表最终稳定到某个数量,就应使用 Web-First 数量断言,让重试机制处理短暂的加载过程。

处理零结果与渲染边界

空结果同样可以用 await expect(items).toHaveCount(0) 表达,它比“某个空态文案存在”更直接地验证集合本身为空。若页面同时要求展示空态提示,可以再独立验证提示元素,不要把两个业务条件混成一个 Locator。

虚拟列表、无限滚动和分页需要额外谨慎:页面可能只把可视区域的一部分数据渲染进 DOM,此时 toHaveCount() 得到的是已渲染节点数,而不是后端返回的总记录数。总数应验证专门的计数字段或接口结果;DOM 数量只用于验证当前实际渲染出的元素集合。

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

目录与阅读设置

阅读设置

17

记录一个想法

断言元素数量

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

登录哪都通