自动化测试 / 系统课时
运行第一个测试
运行第一个测试
本课创建并运行第一个完整的 Playwright 测试案例:启动浏览器、访问公开示例页面,再通过断言验证页面标题。完成后,你将能够从终端判断测试是否通过,并定位常见的执行失败原因。
学习目标
- 创建符合 Playwright Test 规范的测试文件。
- 使用
page.goto()访问网页,理解测试运行器提供的page对象。 - 使用
expect()验证页面状态,并根据终端输出判断测试结果。
创建测试文件
确认当前项目已经安装 @playwright/test 及所需浏览器,并且项目根目录包含 package.json。如果使用前面课时创建的 Playwright 项目,可以直接在现有项目中继续操作。
在项目根目录的 tests 文件夹中创建 example.spec.js。Playwright Test 默认识别符合测试文件命名规则的 .spec.js、.test.js 等文件。
写入以下完整测试代码:
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 事件。如果页面无法访问,导航可能超时;如果页面成功加载但标题不匹配,标题断言会在规定时间内重试,最终报告断言失败。
执行测试
打开项目根目录的终端,执行以下命令,只运行刚才创建的测试文件:
npx playwright test tests/example.spec.js预期输出(仅配置一个浏览器项目时,省略具体测试用例行):
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 函数。它还负责发现测试文件、分配执行工作进程、管理浏览器环境,以及收集断言结果。

对应到刚才的测试,实际过程如下:
- 运行器发现
tests/example.spec.js,读取其中的测试定义。 - 运行器安排 Worker 执行测试,并准备相应的浏览器、隔离的 Browser Context 和 Page。
- 测试函数调用
page.goto(),导航到https://example.com。 expect()检查页面标题。符合条件则通过;达到断言超时时间仍不符合则失败。- 运行器收集结果,由 Reporter 输出测试数量、通过或失败状态及耗时。
默认情况下,Playwright Test 为每个测试提供独立的浏览器上下文,有助于避免 Cookie、Local Storage 等状态在不同测试之间意外共享。
验证断言与排查失败
为了确认测试确实在验证页面状态,可以临时将标题断言中的 Example Domain 改成 Wrong Title,再次执行相同的测试命令。
预期结果:测试最终失败,终端报告标题断言未满足预期条件,并显示期望值与实际页面标题。将断言恢复为 /Example Domain/ 后重新运行,应再次通过。
如果首次执行就失败,可以根据错误信息按以下顺序检查:
- 找不到测试文件:出现
No tests found时,确认当前工作目录是项目根目录,并检查tests/example.spec.js的文件名和路径是否正确。 - 缺少依赖:如果无法解析
@playwright/test,检查项目依赖是否安装完成,并确认当前目录包含正确的package.json。 - 浏览器未安装:出现浏览器可执行文件不存在的提示时,在项目根目录执行
npx playwright install安装 Playwright 所需的浏览器,再重新运行测试。安装成功后,浏览器启动错误应消失。 - 页面访问超时:检查网络连接以及
https://example.com是否能够正常访问。网络不可达时,延长断言等待时间不能解决页面无法加载的问题。 - 标题断言失败:确认实际打开的 URL 和页面标题。注意
toHaveTitle()检查的是 HTML 文档标题,而不是网页中显示的主标题文字。
完成验证后,保留能够通过的标题断言和测试文件。此时已经形成最小的自动化测试闭环:编写用例、执行浏览器操作、检查页面状态,再根据运行结果判断测试是否成功。