自动化测试 / 系统课时
断言元素数量
断言元素数量
列表、表格和搜索结果经常异步更新,数量断言不能只在某一瞬间读取 DOM。这里用 Playwright 的 toHaveCount() 对 Locator 做可重试的精确数量校验,并说明零结果、表格行与虚拟列表等常见边界。
学习目标
- 使用
toHaveCount()验证列表或搜索结果的元素数量 - 理解数量断言为何能配合自动等待处理异步渲染
- 避免因 Locator 范围过大或虚拟化渲染导致误判
用 toHaveCount 检查集合
Locator 可以匹配一组元素,await expect(locator).toHaveCount(n) 会反复重新检查匹配数量,直到等于目标值或断言超时。对于异步加载的列表,这比先调用 count() 再用普通数值断言更稳健,因为后者只读取调用当下的数量。
下面的测试先渲染空列表,稍后一次性插入 3 条搜索结果。断言开始时数量可能仍是 0,但会等待列表达到目标数量。
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()}`);
});预期输出:
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 数量只用于验证当前实际渲染出的元素集合。