自动化测试 / 系统课时
使用标签与占位符定位
使用标签与占位符定位
表单元素通常不需要依赖 CSS 选择器。本课使用 getByLabel()、getByPlaceholder() 和 getByAltText(),分别从字段标签、输入提示和图片替代文本出发建立更接近用户界面的定位方式。
学习目标
- 使用
getByLabel()定位具有可访问标签的表单控件 - 使用
getByPlaceholder()定位带输入提示的字段 - 使用
getByAltText()定位具有替代文本的图片等元素
优先从标签定位表单控件
getByLabel() 适合输入框、选择框等表单控件。它能依据关联的 <label> 文本,也能利用 aria-label 或 aria-labelledby 提供的可访问名称,因此页面即使调整 DOM 层级,只要表单语义不变,定位通常仍然稳定。
标签和控件可以通过 for 与 id 关联,也可以把控件直接放在 <label> 内。测试代码不需要知道这种结构细节,只需要使用用户在界面上看到或辅助技术读取到的标签文字。
占位符与替代文本各有职责
getByPlaceholder() 根据输入元素的 placeholder 属性定位,适合没有明确标签、但存在稳定输入提示的场景。若一个字段同时有标签和占位符,通常优先使用标签,因为占位符只是输入提示,填写内容后会消失,也更容易因产品文案调整而变化。
getByAltText() 根据替代文本定位元素,最常用于带 alt 的图片。替代文本本身承担可访问性语义,因此比图片文件名或复杂 CSS 路径更能表达“这张图在页面上代表什么”。
下面用一个自包含页面验证三种定位方式。将内容保存为 form-locators.spec.ts:
import { test, expect } from '@playwright/test';
test('使用标签、占位符和替代文本定位', async ({ page }) => {
await page.setContent(`
<main>
<label for="email">邮箱</label>
<input id="email" placeholder="name@example.com">
<input aria-label="搜索商品" placeholder="输入关键词">
<img src="/cover.png" alt="课程封面">
</main>
`);
// 有明确表单标签时优先按标签填写。
await page.getByLabel('邮箱').fill('student@example.com');
// 没有可见标签时,可以按稳定的 placeholder 定位。
await page.getByPlaceholder('输入关键词').fill('Playwright');
await expect(page.getByLabel('邮箱'))
.toHaveValue('student@example.com');
await expect(page.getByPlaceholder('输入关键词'))
.toHaveValue('Playwright');
// alt 文本直接表达图片对用户的含义。
await expect(page.getByAltText('课程封面'))
.toHaveAttribute('src', '/cover.png');
});在已安装 Playwright Test 的项目目录运行:
npx playwright test form-locators.spec.ts预期输出:
1 passed (<TIME>)实际执行时间可能不同;只要三个断言都通过,就说明定位器找到了对应表单控件和图片。
选择最合适的定位依据
标签、占位符和替代文本并不是可以随意互换的三种写法。它们分别对应不同的页面语义:表单字段优先标签,缺少标签但有输入提示时再考虑占位符,图片等具有文本替代信息的元素使用替代文本。
如果标签或占位符存在相似文案,可以使用精确匹配,例如 getByLabel('邮箱', { exact: true })。当页面结构中出现多个语义相同的控件时,应先限定业务区域或补充更明确的可访问名称,而不是依赖 .nth() 固定索引。
这类定位器的共同原则是优先使用用户可感知的页面语义。只要界面文案和可访问关系稳定,测试就不必绑定脆弱的类名、层级或自动生成的 DOM 属性。