自动化测试 / 系统课时
过滤定位结果
过滤定位结果
一个定位器经常先匹配一组候选元素,再根据文本、子元素或排除条件缩小到真正目标。Playwright 的 locator.filter() 可以在已有 Locator 上继续筛选,比依赖 nth() 的位置选择更能适应列表顺序和页面结构变化。
学习目标
- 使用
hasText和has缩小定位器的匹配范围 - 理解过滤条件相对于外层候选元素进行匹配的规则
- 使用排除条件避免依赖列表位置选择元素
从候选集合开始筛选
过滤的关键不是“重新从整个页面搜索”,而是先得到一组外层候选,再逐个判断候选是否满足条件。例如先用 getByRole('listitem') 找到商品卡片,再通过 hasText 保留包含指定文字的卡片。
hasText 接受字符串或正则表达式。字符串匹配会在候选元素及其后代文本中查找,并进行不区分大小写的子串匹配;需要更精确的规则时,可以传入正则表达式。
同时按文本和子元素过滤
下面的测试包含三个商品项。目标不是“第二个列表项”,而是“名称包含 Playwright Pro,并且内部存在购买按钮的商品项”。即使列表重新排序,只要这些业务条件不变,定位仍然有效。
import { test, expect } from '@playwright/test';
test('过滤商品列表中的目标项', async ({ page }) => {
await page.setContent(`
<ul aria-label="商品列表">
<li><span>Playwright Basic</span><button>购买</button></li>
<li><span>Playwright Pro</span><button>购买</button></li>
<li><span>Playwright Pro</span><span>暂不可购买</span></li>
</ul>
`);
const products = page.getByRole('listitem');
// hasText 检查候选项文本,has 要求候选项内部还存在匹配的后代元素。
const purchasablePro = products
.filter({ hasText: 'Playwright Pro' })
.filter({ has: page.getByRole('button', { name: '购买' }) });
await expect(purchasablePro).toHaveCount(1);
await purchasablePro.getByRole('button', { name: '购买' }).click();
});预期结果:两个含有 Playwright Pro 的列表项先被文本条件命中,随后只有包含“购买”按钮的候选项保留下来,因此计数断言为 1,点击成功。
1 passed (<TIME>)理解 has 的相对范围
has 中的内部 Locator 会相对于每一个外层候选元素执行匹配,而不是从文档根节点开始。外层和内部 Locator 还必须位于同一个 frame 中,内部条件不能跨到另一个 frame。
这意味着应先选出语义明确的容器,再描述“这个容器里面必须有什么”。例如商品卡片、表格行、文章卡片都适合作为外层候选;不要让内部 Locator 依赖候选元素之外的祖先节点,否则条件与实际查询范围不一致。
使用排除条件缩小集合
当需求是“保留不包含某种状态的项”时,可以使用 hasNotText;当需求是“内部不能存在某个元素”时,可以使用 hasNot。它们与 hasText、has 的作用方向相反,但仍然基于已有候选集合过滤。
例如库存列表可以先定位所有商品项,再用 filter({ hasNotText: '售罄' }) 保留可考虑购买的项。只有当顺序本身就是业务规则时才使用 first()、last() 或 nth();如果存在文本、子元素或状态条件,优先把这些条件写进 Locator,测试会更容易读懂,也更不容易点错元素。