自动化测试 / 系统课时

断言页面 URL 与标题

断言页面 URL 与标题

导航测试的核心不是“点击成功”,而是确认浏览器最终到达正确地址,并加载了预期页面标题。本节使用 toHaveURL() 与 toHaveTitle() 验证导航结果,同时说明字符串、正则匹配以及重定向后的断言边界。

学习目标

  • 使用 toHaveURL() 验证最终页面地址
  • 使用 toHaveTitle() 验证文档标题
  • 为动态查询参数和重定向选择合适的匹配方式

URL 与标题各验证一层结果

toHaveURL() 断言当前页面 URL,适合确认路由跳转、登录重定向和关键查询参数。toHaveTitle() 读取最终文档的标题,能补充验证“虽然地址正确,但加载了错误页面”这类问题。

这两个断言都是 Web-first 断言,会在超时前持续等待页面状态满足条件。因此,触发导航后通常可以直接断言,不需要额外添加固定延时。

构造一个确定性的导航测试

下面的示例使用 data: URL,不依赖外部服务。导航完成后同时检查 URL 协议前缀和页面标题,可直接保存为 navigation-assertions.spec.ts。

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');
});

运行测试:

bash
npx playwright test navigation-assertions.spec.ts

预期输出的关键结果:

text
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 负责确认“到了哪里”,标题负责确认“加载了什么页面”。两者一起使用,可以把导航测试从单纯检查点击动作,提升为对最终页面状态的完整验收。

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

目录与阅读设置

阅读设置

17

记录一个想法

断言页面 URL 与标题

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

登录哪都通