自动化测试 / 系统课时
打开页面与等待加载
打开页面与等待加载
页面导航的关键不是“等得越久越安全”,而是选择正确的完成边界,再用页面断言确认业务内容已经可用。本节用 page.goto()、加载状态和可见性断言建立一套稳定的等待方式。
学习目标
- 使用
page.goto()打开页面并选择合适的waitUntil - 区分
commit、domcontentloaded、load与networkidle - 避免把网络空闲误当成页面业务就绪
用 goto 建立导航边界
page.goto(url) 默认等待到 load。如果只需要 DOM 已解析,可以显式使用 waitUntil: 'domcontentloaded';随后再按需要等待完整 load。下面的测试启动一个本地 HTTP 服务,并故意让样式文件延迟返回,从而让两个阶段可以被清楚观察。
在已安装 Playwright Test 的项目中,将代码保存为 tests/navigation.spec.ts,并执行 npx playwright test tests/navigation.spec.ts:
import { test, expect } from '@playwright/test';
import { createServer } from 'node:http';
test('wait for DOM then full load', async ({ page }) => {
const server = createServer((req, res) => {
if (req.url === '/slow.css') {
setTimeout(() => {
res.writeHead(200, { 'Content-Type': 'text/css' });
res.end('body{font-family:sans-serif}');
}, 300);
return;
}
res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
res.end('<title>加载演示</title><link rel="stylesheet" href="/slow.css"><h1>Ready</h1>');
});
await new Promise<void>(resolve => server.listen(0, '127.0.0.1', resolve));
const address = server.address();
if (!address || typeof address === 'string') throw new Error('server start failed');
try {
await page.goto(`http://127.0.0.1:${address.port}`, {
waitUntil: 'domcontentloaded',
});
console.log('DOMContentLoaded reached');
await page.waitForLoadState('load');
await expect(page.getByRole('heading', { name: 'Ready' })).toBeVisible();
console.log('load reached');
} finally {
await new Promise<void>(resolve => server.close(() => resolve()));
}
});预期输出(测试运行器的路径与耗时信息可能不同):
DOMContentLoaded reached
load reached理解不同加载状态
导航的几个状态代表不同的浏览器事件边界,不代表应用一定已经完成业务初始化。
| 状态 | 含义 | 适合场景 |
|---|---|---|
commit |
已收到响应,文档开始加载 | 只关心导航已经开始提交 |
domcontentloaded |
DOM 已解析完成 | 后续只依赖 DOM 结构 |
load |
页面及阻塞 load 的资源已完成 |
需要传统页面加载完成 |
networkidle |
一段时间没有网络连接 | Playwright 不建议把它作为测试就绪依据 |
page.goto() 的 waitUntil 可以使用以上四种值;page.waitForLoadState() 则用于等待 load、domcontentloaded 或 networkidle,不提供 commit 状态。

用断言判断真正可用
加载状态只能说明浏览器走到了某个阶段。单页应用可能在 load 之后继续请求接口、渲染按钮或更新文本,因此更稳妥的做法是等待与测试目标直接相关的元素或状态,例如 await expect(page.getByRole('heading', { name: 'Ready' })).toBeVisible()。
选择等待边界时,先让导航等待到足以继续执行的浏览器状态,再把“业务是否就绪”交给 Locator 和 Web 断言判断。这样既避免无意义的固定等待,也能让失败原因更接近真实页面状态。