自动化测试 / 系统课时
组合链式定位器
组合链式定位器
页面中经常有多个名称相同的按钮或文本,仅靠一次全局定位很容易命中错误元素。链式定位器的关键是先找到稳定的父容器,再逐层缩小搜索范围,让定位表达页面真实的层级关系。
学习目标
- 理解 Playwright 链式定位器如何逐步缩小查找范围
- 使用
filter()与子定位器准确锁定重复组件中的目标元素 - 判断什么时候应该继续链式定位,什么时候应简化定位表达式
链式定位的核心语义
Playwright 的 Locator 可以继续调用 getByRole()、getByText()、locator() 等方法。后一个定位器默认只在前一个 Locator 匹配元素的后代范围内搜索,而不是重新从整个页面开始查找。
例如页面上存在十个“删除”按钮时,与其尝试寻找“第三个删除按钮”,更稳定的表达方式通常是先定位代表某条记录的容器,再从这个容器内部寻找“删除”按钮。页面新增其他记录后,这种定位关系仍然成立。
链式定位可以理解为不断收窄作用域:页面 → 目标组件 → 组件中的目标控件。这种写法不仅减少误匹配,也能让测试代码直接体现页面结构。
从父容器逐步缩小范围
下面的测试页面包含两个套餐卡片,每张卡片都有一个“立即购买”按钮。真正区分按钮的不是按钮本身,而是它所在的套餐卡片。
import { test, expect } from '@playwright/test';
test('从商品卡片定位购买按钮', async ({ page }) => {
await page.setContent(`
<main>
<article>
<h2>基础套餐</h2>
<p>¥99/月</p>
<button>立即购买</button>
</article>
<article>
<h2>Pro 套餐</h2>
<p>¥199/月</p>
<button>立即购买</button>
</article>
</main>
`);
// 先通过内部标题筛选正确的父容器,再在该范围内寻找按钮。
const proCard = page.getByRole('article').filter({
has: page.getByRole('heading', { name: 'Pro 套餐' }),
});
const buyButton = proCard.getByRole('button', { name: '立即购买' });
await expect(proCard.getByText('¥199/月')).toBeVisible();
await expect(buyButton).toBeEnabled();
});将文件保存为 tests/locator-chain.spec.ts 后运行:
npx playwright test tests/locator-chain.spec.ts预期输出的关键结果如下,实际耗时会有所不同:
1 passed (<TIME>)这里如果直接写 page.getByRole('button', { name: '立即购买' }),会同时命中两个按钮。链式写法先把范围缩小到包含“Pro 套餐”标题的 article,随后按钮定位只在该卡片内部生效。
用 filter 表达组件条件
filter() 适合处理“先找到一组候选容器,再根据容器内容筛选”的页面结构。常用条件包括 hasText 和 has:前者检查容器中的文本,后者要求容器内部存在另一个 Locator 匹配的元素。
当组件有明确的标题、标签或子控件时,has 往往比长 CSS 路径更能表达测试意图。例如“找到包含标题 Pro 套餐的卡片”描述的是业务关系,而不是“找到第二个 div 的第三层子节点”。
链式定位的边界
链式调用通常向当前元素的后代继续查找。如果目标元素并不是父容器的后代,例如需要先根据某个文本找到其兄弟元素,就应该先重新选择能够同时包含两者的公共容器,而不是强行把 DOM 相邻关系拼成长 CSS 选择器。
同时避免把链式定位写成 DOM 路径复刻,例如连续使用 locator('div').locator('div').locator('button')。这种代码虽然形式上是链式的,但依旧依赖无语义的标签层级。更稳妥的原则是:父级负责限定业务范围,子级负责通过角色、标签或稳定测试标识找到最终控件。