自动化测试 / 系统课时

编写 test 测试用例

编写 test 测试用例

本课解决如何在 Playwright 中定义可执行测试的问题。完成学习后,你可以创建基础测试函数,理解异步执行流程,并运行第一个自动化测试。

学习目标

  • 理解 test 函数的基本结构和命名方式。
  • 掌握异步测试中 async 和 await 的使用规则。
  • 能够编写、运行并验证简单的 Playwright 测试。

测试用例的基本结构

Playwright Test 使用 test 定义一个测试用例。测试名称用于描述行为,回调函数中编写浏览器操作和断言。由于浏览器 API 大多是异步的,测试函数通常需要声明为 async。

一个测试通常包含三个部分:

  1. 测试名称:例如“验证首页标题”,用于在运行结果和失败报告中标识测试。
  2. 测试回调:async ({ page }) => { ... },接收 Playwright 提供的 page 测试夹具(fixture)。
  3. 操作与断言:先使用 page.goto() 打开页面,再使用 expect() 检查实际结果是否符合预期。

page 不是需要手动创建的全局变量。Playwright Test 会为测试提供独立的页面环境,并管理相关资源的初始化和清理。

Playwright 测试用例执行流程图

编写第一个测试

下面示例验证页面标题是否正确。在已经安装 @playwright/test 并安装 Chromium 浏览器的项目中,新建文件 tests/example.spec.ts,写入以下完整代码。示例访问公开网站,执行时需要能够连接互联网。

ts
import { test, expect } from '@playwright/test';

test('验证首页标题', async ({ page }) => {
  // 等待导航完成,避免断言在页面加载前执行
  await page.goto('https://example.com');

  // 标题断言会自动重试,直到匹配或超时
  await expect(page).toHaveTitle(/Example Domain/);
});

预期结果:浏览器成功访问 https://example.com 后,页面标题为 Example Domain,正则表达式匹配成功,测试通过。如果标题始终不符合预期,断言会在超时后失败,并报告实际值与期望值。

这里有两个需要理解的执行细节。

首先,await page.goto() 会等待导航操作对应的 Promise 完成。如果遗漏 await,后续代码可能在导航尚未完成时执行,还可能产生未处理的异步错误。

其次,await expect(page).toHaveTitle() 是 Playwright 的自动重试断言。它会在断言超时范围内重新检查标题,不需要为页面加载手动添加固定延时。默认断言超时通常为 5000 毫秒,也可以通过项目配置调整。

运行与验证测试

在项目根目录打开终端,确认测试文件位于 tests/example.spec.ts,然后执行:

bash
npx playwright test tests/example.spec.ts

预期输出(仅启用一个浏览器项目且测试通过时,节选):

text
1 passed (<TIME>)

<TIME> 表示实际执行耗时,每次运行可能不同。终端通常还会显示测试数量、工作进程数量和测试名称。如果项目配置了 Chromium、Firefox、WebKit 等多个浏览器项目,同一个测试可能执行多次,通过数量也会相应增加。

确认测试通过后,可以临时把 toHaveTitle(/Example Domain/) 中的预期值改为 toHaveTitle('Wrong title'),再次运行同一命令。

预期结果:断言持续不匹配并在超时后失败,测试运行器报告期望标题与实际标题的差异。验证完成后,将断言恢复为原来的表达式。

这个操作可以确认测试确实执行了断言,而不只是成功打开网页。

常见边界

测试名称应该描述用户行为,例如“用户登录成功”,而不是“测试按钮”。清晰的名称可以帮助快速定位失败原因。同一文件中可以定义多个 test,每个测试都应有明确且独立的验证目标。

test 的回调必须正确处理异步操作。浏览器导航、点击和 Playwright 的异步断言都应使用 await。不要通过省略 await 来缩短执行时间,也不要依赖固定等待时间掩盖页面状态问题。

page 由 Playwright Test 的测试夹具提供,测试结束后框架会清理相关页面和上下文资源。使用标准测试运行器时,不需要在每个测试内部调用 chromium.launch() 和 browser.close() 来替代框架的生命周期管理。

对于标题必须完全一致的场景,可以使用字符串断言 toHaveTitle('Example Domain');当前示例使用的正则表达式 /Example Domain/ 允许标题包含其他字符。选择哪种方式取决于测试是否要求精确匹配。

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

目录与阅读设置

阅读设置

17

记录一个想法

编写 test 测试用例

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

登录哪都通