自动化测试 / 系统课时
使用测试标识定位
使用测试标识定位
当页面文案、样式类名或 DOM 层级经常调整时,可以把测试需要的稳定标识作为显式契约,再用 getByTestId() 定位。这样测试不必绑定脆弱的 CSS 路径,同时仍能保留 Playwright Locator 的自动等待与重试能力。
学习目标
- 使用
getByTestId()定位带测试标识的元素 - 设计不会随样式和布局变化而频繁失效的测试标识
- 判断测试标识与角色、文本定位各自适合的场景
把测试标识当作测试契约
Playwright 默认把 data-testid 作为测试标识属性。测试代码只关心标识值,不需要知道按钮位于第几个 div、使用了什么 CSS 类名,也不会因为外层容器重排就失效。
一个好的测试标识应表达稳定的业务含义,例如 checkout-submit、profile-email。不要把数组下标、随机 ID、样式名或当前 DOM 层级编码进去,否则只是把脆弱的 CSS 选择器换了一种写法。
使用 getByTestId
下面的测试通过 page.setContent() 构造最小页面,因此保存为测试文件后即可直接运行。页面结构可以改变,只要 data-testid="checkout-submit" 仍保留,定位表达式就不需要跟着修改。
import { test, expect } from '@playwright/test';
test('通过稳定测试标识提交订单', async ({ page }) => {
await page.setContent(`
<main>
<section class="checkout-panel">
<button data-testid="checkout-submit">提交订单</button>
</section>
</main>
`);
// 测试只依赖约定好的标识,不依赖容器层级或样式类名。
const submitButton = page.getByTestId('checkout-submit');
await expect(submitButton).toBeVisible();
await expect(submitButton).toHaveText('提交订单');
await submitButton.click();
});预期结果:运行该测试时,定位器唯一匹配按钮,两条断言和点击操作均成功,测试进程正常通过。具体耗时会因机器环境不同而变化。
1 passed (<TIME>)需要自定义属性时
团队已有统一属性时,不必强制改成 data-testid。可以在 Playwright 配置的 use.testIdAttribute 中指定例如 data-pw,之后业务测试仍继续调用 getByTestId('checkout-submit'),测试代码不需要感知底层属性名。
配置自定义属性后,页面应使用同一个约定,例如 data-pw="checkout-submit"。验证重点不是属性名称本身,而是配置、页面标记和测试契约三者保持一致。
避免测试标识失去稳定性
同一页面中的标识应尽量唯一,否则对单元素执行 click() 等严格操作时会因为匹配多个元素而报错。列表项确实重复时,应先定位稳定容器,再结合文本、子元素或其他条件缩小范围,而不是随意调用 nth() 固定当前位置。
测试标识也应随着业务语义而不是页面外观演进。只要“提交订单”仍是同一个业务动作,即使按钮从侧边栏移到弹窗、CSS 框架被替换,checkout-submit 通常都无需改变,这正是它降低结构变更影响的价值。