自动化测试 / 系统课时
断言页面 URL 与标题
断言页面 URL 与标题
导航测试的核心不是“点击成功”,而是确认浏览器最终到达正确地址,并加载了预期页面标题。本节使用 toHaveURL() 与 toHaveTitle() 验证导航结果,同时说明字符串、正则匹配以及重定向后的断言边界。
学习目标
- 使用
toHaveURL()验证最终页面地址 - 使用
toHaveTitle()验证文档标题 - 为动态查询参数和重定向选择合适的匹配方式
URL 与标题各验证一层结果
toHaveURL() 断言当前页面 URL,适合确认路由跳转、登录重定向和关键查询参数。toHaveTitle() 读取最终文档的标题,能补充验证“虽然地址正确,但加载了错误页面”这类问题。
这两个断言都是 Web-first 断言,会在超时前持续等待页面状态满足条件。因此,触发导航后通常可以直接断言,不需要额外添加固定延时。
构造一个确定性的导航测试
下面的示例使用 data: URL,不依赖外部服务。导航完成后同时检查 URL 协议前缀和页面标题,可直接保存为 navigation-assertions.spec.ts。
import { test, expect } from '@playwright/test';
test('assert page URL and title', async ({ page }) => {
await page.goto(
'data:text/html,<title>Dashboard</title><h1>Dashboard</h1>'
);
// URL 可能包含编码后的正文,因此只匹配稳定前缀。
await expect(page).toHaveURL(/^data:text\/html,/);
// 标题来自 document.title,适合确认最终页面身份。
await expect(page).toHaveTitle('Dashboard');
});运行测试:
npx playwright test navigation-assertions.spec.ts预期输出的关键结果:
Running 1 test using 1 worker
1 passed (<TIME>)实际耗时和输出细节可能不同,但测试通过时应出现 1 passed。
精确字符串与正则各有用途
地址完全固定时可以直接传字符串,例如断言一个稳定的静态页面。真实应用更常包含动态查询参数、随机 ID 或可选尾斜杠,此时正则表达式能只约束业务真正关心的部分。
例如登录后只要求最终进入 /dashboard,就可以使用 await expect(page).toHaveURL(/\/dashboard$/)。如果测试还需要确认查询参数,应该把参数本身纳入断言,而不是把整个 URL 放宽到过于模糊的匹配。
重定向场景要断言最终状态
当一次点击触发多次跳转时,通常应断言最终 URL,而不是中间地址。toHaveURL() 会读取当前页面状态并自动重试,因此适合等待登录回调、服务端重定向或前端路由完成。
标题也可能在页面加载后由脚本更新。此时直接使用 toHaveTitle() 比先读取 page.title() 再做普通相等比较更稳,因为前者会自动等待目标标题出现。
URL 负责确认“到了哪里”,标题负责确认“加载了什么页面”。两者一起使用,可以把导航测试从单纯检查点击动作,提升为对最终页面状态的完整验收。