自动化测试 / 系统课时

打开页面与等待加载

打开页面与等待加载

页面导航的关键不是“等得越久越安全”,而是选择正确的完成边界,再用页面断言确认业务内容已经可用。本节用 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:

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

预期输出(测试运行器的路径与耗时信息可能不同):

text
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 断言判断。这样既避免无意义的固定等待,也能让失败原因更接近真实页面状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

打开页面与等待加载

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

登录哪都通