自动化测试 / 系统课时

运行第一个测试

运行第一个测试

本课创建并运行第一个完整的 Playwright 测试案例:启动浏览器、访问公开示例页面,再通过断言验证页面标题。完成后,你将能够从终端判断测试是否通过,并定位常见的执行失败原因。

学习目标

  • 创建符合 Playwright Test 规范的测试文件。
  • 使用 page.goto() 访问网页,理解测试运行器提供的 page 对象。
  • 使用 expect() 验证页面状态,并根据终端输出判断测试结果。

创建测试文件

确认当前项目已经安装 @playwright/test 及所需浏览器,并且项目根目录包含 package.json。如果使用前面课时创建的 Playwright 项目,可以直接在现有项目中继续操作。

在项目根目录的 tests 文件夹中创建 example.spec.js。Playwright Test 默认识别符合测试文件命名规则的 .spec.js、.test.js 等文件。

写入以下完整测试代码:

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

test('open example page', async ({ page }) => {
  await page.goto('https://example.com');

  // 标题断言会在超时前自动重试,等待页面满足预期条件。
  await expect(page).toHaveTitle(/Example Domain/);
});

预期结果:文件保存后不会立即产生终端输出。由 Playwright Test 运行器执行该文件时,浏览器访问 https://example.com,页面标题匹配 Example Domain,断言通过。

这段代码包含三个关键部分:

  • test() 定义一个测试用例,第一个参数是测试名称,第二个参数是异步测试函数。
  • page 是 Playwright Test 提供的测试夹具(Fixture),代表当前测试使用的浏览器页面。运行器负责创建与清理测试所需的页面和上下文,无须在这里手动启动浏览器。
  • expect(page).toHaveTitle() 验证页面标题。正则表达式 /Example Domain/ 表示标题中包含对应文本即可通过。

page.goto() 默认等待页面的 load 事件。如果页面无法访问,导航可能超时;如果页面成功加载但标题不匹配,标题断言会在规定时间内重试,最终报告断言失败。

执行测试

打开项目根目录的终端,执行以下命令,只运行刚才创建的测试文件:

bash
npx playwright test tests/example.spec.js

预期输出(仅配置一个浏览器项目时,省略具体测试用例行):

text
Running 1 test using 1 worker

  1 passed (<TIME>)

其中 1 passed 表示一个测试执行成功。<TIME> 代表实际耗时,会因电脑性能和网络状态而变化。

如果 playwright.config.js 配置了 Chromium、Firefox、WebKit 等多个浏览器项目,同一测试可能分别执行多次,因此终端可能显示 3 passed,而不只是 1 passed。终端的具体排版也会随报告器配置变化。

执行命令后,Playwright 默认以无头模式运行浏览器,因此通常不会弹出可见的浏览器窗口。只要测试通过,终端就会报告成功;没有看到浏览器窗口不代表测试没有执行。

理解测试执行链路

Playwright Test 不只是运行一个 JavaScript 函数。它还负责发现测试文件、分配执行工作进程、管理浏览器环境,以及收集断言结果。

Playwright 测试从运行器到浏览器断言及结果报告的执行链路

对应到刚才的测试,实际过程如下:

  1. 运行器发现 tests/example.spec.js,读取其中的测试定义。
  2. 运行器安排 Worker 执行测试,并准备相应的浏览器、隔离的 Browser Context 和 Page。
  3. 测试函数调用 page.goto(),导航到 https://example.com。
  4. expect() 检查页面标题。符合条件则通过;达到断言超时时间仍不符合则失败。
  5. 运行器收集结果,由 Reporter 输出测试数量、通过或失败状态及耗时。

默认情况下,Playwright Test 为每个测试提供独立的浏览器上下文,有助于避免 Cookie、Local Storage 等状态在不同测试之间意外共享。

验证断言与排查失败

为了确认测试确实在验证页面状态,可以临时将标题断言中的 Example Domain 改成 Wrong Title,再次执行相同的测试命令。

预期结果:测试最终失败,终端报告标题断言未满足预期条件,并显示期望值与实际页面标题。将断言恢复为 /Example Domain/ 后重新运行,应再次通过。

如果首次执行就失败,可以根据错误信息按以下顺序检查:

  1. 找不到测试文件:出现 No tests found 时,确认当前工作目录是项目根目录,并检查 tests/example.spec.js 的文件名和路径是否正确。
  2. 缺少依赖:如果无法解析 @playwright/test,检查项目依赖是否安装完成,并确认当前目录包含正确的 package.json。
  3. 浏览器未安装:出现浏览器可执行文件不存在的提示时,在项目根目录执行 npx playwright install 安装 Playwright 所需的浏览器,再重新运行测试。安装成功后,浏览器启动错误应消失。
  4. 页面访问超时:检查网络连接以及 https://example.com 是否能够正常访问。网络不可达时,延长断言等待时间不能解决页面无法加载的问题。
  5. 标题断言失败:确认实际打开的 URL 和页面标题。注意 toHaveTitle() 检查的是 HTML 文档标题,而不是网页中显示的主标题文字。

完成验证后,保留能够通过的标题断言和测试文件。此时已经形成最小的自动化测试闭环:编写用例、执行浏览器操作、检查页面状态,再根据运行结果判断测试是否成功。

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

目录与阅读设置

阅读设置

17

记录一个想法

运行第一个测试

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

登录哪都通