自动化测试 / 系统课时

断言元素可见性

断言元素可见性

本篇解决 Playwright 中最常见的元素状态验证问题:如何可靠判断元素已经出现、已经隐藏,以及控件当前是否可用。完成后,你可以直接使用 Web-first 断言,让测试等待目标状态成立,而不是手工插入固定延时。

学习目标

  • 使用 toBeVisible() 与 toBeHidden() 验证元素显示状态
  • 使用 toBeEnabled() 与 toBeDisabled() 验证交互状态
  • 理解状态断言的自动重试行为与隐藏断言的边界

用状态断言代替手工等待

Playwright 的 Locator 断言会自动重试,直到条件成立或断言超时。因此,页面正在异步更新时,不需要先写固定的 waitForTimeout()。例如元素稍后才显示,await expect(locator).toBeVisible() 会持续重新检查目标元素。

可见性和可用性是两类不同状态。一个按钮即使能看见,也可能因为 disabled 或 aria-disabled 而不可用;反过来,验证“按钮可点击”时,也不应只检查它是否存在于 DOM 中。

验证可见、隐藏、启用和禁用

下面的测试通过 page.setContent() 构造最小页面,不依赖外部站点。提示消息会在短暂延迟后显示,用它可以直接观察断言的自动等待效果。

ts
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。

预期输出

text
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 里有没有这个元素”,而是检查用户真正能观察或操作到的状态。把断言写成业务结果,并利用自动重试等待页面达到该结果,通常比固定延时更稳定。

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

目录与阅读设置

阅读设置

17

记录一个想法

断言元素可见性

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

登录哪都通