自动化测试 / 系统课时

使用标签与占位符定位

使用标签与占位符定位

表单元素通常不需要依赖 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:

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 的项目目录运行:

bash
npx playwright test form-locators.spec.ts

预期输出:

text
1 passed (<TIME>)

实际执行时间可能不同;只要三个断言都通过,就说明定位器找到了对应表单控件和图片。

选择最合适的定位依据

标签、占位符和替代文本并不是可以随意互换的三种写法。它们分别对应不同的页面语义:表单字段优先标签,缺少标签但有输入提示时再考虑占位符,图片等具有文本替代信息的元素使用替代文本。

如果标签或占位符存在相似文案,可以使用精确匹配,例如 getByLabel('邮箱', { exact: true })。当页面结构中出现多个语义相同的控件时,应先限定业务区域或补充更明确的可访问名称,而不是依赖 .nth() 固定索引。

这类定位器的共同原则是优先使用用户可感知的页面语义。只要界面文案和可访问关系稳定,测试就不必绑定脆弱的类名、层级或自动生成的 DOM 属性。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用标签与占位符定位

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

登录哪都通