自动化测试 / 系统课时

过滤定位结果

过滤定位结果

一个定位器经常先匹配一组候选元素,再根据文本、子元素或排除条件缩小到真正目标。Playwright 的 locator.filter() 可以在已有 Locator 上继续筛选,比依赖 nth() 的位置选择更能适应列表顺序和页面结构变化。

学习目标

  • 使用 hasText 和 has 缩小定位器的匹配范围
  • 理解过滤条件相对于外层候选元素进行匹配的规则
  • 使用排除条件避免依赖列表位置选择元素

从候选集合开始筛选

过滤的关键不是“重新从整个页面搜索”,而是先得到一组外层候选,再逐个判断候选是否满足条件。例如先用 getByRole('listitem') 找到商品卡片,再通过 hasText 保留包含指定文字的卡片。

hasText 接受字符串或正则表达式。字符串匹配会在候选元素及其后代文本中查找,并进行不区分大小写的子串匹配;需要更精确的规则时,可以传入正则表达式。

同时按文本和子元素过滤

下面的测试包含三个商品项。目标不是“第二个列表项”,而是“名称包含 Playwright Pro,并且内部存在购买按钮的商品项”。即使列表重新排序,只要这些业务条件不变,定位仍然有效。

ts
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,点击成功。

text
1 passed (<TIME>)

理解 has 的相对范围

has 中的内部 Locator 会相对于每一个外层候选元素执行匹配,而不是从文档根节点开始。外层和内部 Locator 还必须位于同一个 frame 中,内部条件不能跨到另一个 frame。

这意味着应先选出语义明确的容器,再描述“这个容器里面必须有什么”。例如商品卡片、表格行、文章卡片都适合作为外层候选;不要让内部 Locator 依赖候选元素之外的祖先节点,否则条件与实际查询范围不一致。

使用排除条件缩小集合

当需求是“保留不包含某种状态的项”时,可以使用 hasNotText;当需求是“内部不能存在某个元素”时,可以使用 hasNot。它们与 hasText、has 的作用方向相反,但仍然基于已有候选集合过滤。

例如库存列表可以先定位所有商品项,再用 filter({ hasNotText: '售罄' }) 保留可考虑购买的项。只有当顺序本身就是业务规则时才使用 first()、last() 或 nth();如果存在文本、子元素或状态条件,优先把这些条件写进 Locator,测试会更容易读懂,也更不容易点错元素。

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

目录与阅读设置

阅读设置

17

记录一个想法

过滤定位结果

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

登录哪都通