自动化测试 / 系统课时
断言元素可见性
断言元素可见性
本篇解决 Playwright 中最常见的元素状态验证问题:如何可靠判断元素已经出现、已经隐藏,以及控件当前是否可用。完成后,你可以直接使用 Web-first 断言,让测试等待目标状态成立,而不是手工插入固定延时。
学习目标
- 使用
toBeVisible()与toBeHidden()验证元素显示状态 - 使用
toBeEnabled()与toBeDisabled()验证交互状态 - 理解状态断言的自动重试行为与隐藏断言的边界
用状态断言代替手工等待
Playwright 的 Locator 断言会自动重试,直到条件成立或断言超时。因此,页面正在异步更新时,不需要先写固定的 waitForTimeout()。例如元素稍后才显示,await expect(locator).toBeVisible() 会持续重新检查目标元素。
可见性和可用性是两类不同状态。一个按钮即使能看见,也可能因为 disabled 或 aria-disabled 而不可用;反过来,验证“按钮可点击”时,也不应只检查它是否存在于 DOM 中。
验证可见、隐藏、启用和禁用
下面的测试通过 page.setContent() 构造最小页面,不依赖外部站点。提示消息会在短暂延迟后显示,用它可以直接观察断言的自动等待效果。
import { test, expect } from '@playwright/test';
test('验证元素状态', async ({ page }) => {
await page.setContent(`
<button id="submit">提交订单</button>
<button id="delete" disabled>删除订单</button>
<p id="notice" hidden>提交成功</p>
<p id="tip" hidden>内部提示</p>
<script>
setTimeout(() => {
document.querySelector('#notice').hidden = false;
}, 100);
</script>
`);
// notice 初始隐藏,断言会等待脚本把它显示出来。
await expect(page.locator('#notice')).toBeVisible();
await expect(page.locator('#tip')).toBeHidden();
// 可见不等于可用,交互状态应单独验证。
await expect(page.getByRole('button', { name: '提交订单' })).toBeEnabled();
await expect(page.getByRole('button', { name: '删除订单' })).toBeDisabled();
});将文件保存为 visibility.spec.ts 后运行 npx playwright test visibility.spec.ts。
预期输出
Running 1 test using 1 worker
✓ 1 visibility.spec.ts:<ID> › 验证元素状态
1 passed (<TIME>)测试编号、行号和耗时会随环境变化;只要四个断言都在超时前满足,测试就会通过。
理解隐藏状态的边界
toBeVisible() 要求 Locator 最终指向一个已连接到页面且可见的 DOM 节点。toBeHidden() 的语义更宽:目标节点不可见时会通过,Locator 最终没有匹配到任何节点时也会通过。
这意味着“元素已从 DOM 删除”和“元素仍存在但被隐藏”都可能满足 toBeHidden()。如果业务要求元素必须保留在 DOM 中,只是暂时不可见,应同时验证它仍然存在,再验证隐藏状态。
选择与业务语义一致的断言
验证加载提示消失时,使用 toBeHidden();验证弹窗已经展示时,使用 toBeVisible();验证提交按钮允许操作时,使用 toBeEnabled();验证权限不足或表单未满足条件时,使用 toBeDisabled()。
状态断言的关键不是“DOM 里有没有这个元素”,而是检查用户真正能观察或操作到的状态。把断言写成业务结果,并利用自动重试等待页面达到该结果,通常比固定延时更稳定。