自动化测试 / 系统课时

处理新标签页

处理新标签页

点击链接后如果站点通过 target="_blank" 或 window.open() 打开新标签页,原来的 page 不会自动变成新页面。正确做法是在触发点击之前开始等待 popup 事件,拿到新的 Page 对象后,再对它执行定位、断言和关闭操作。

学习目标

  • 使用 page.waitForEvent('popup') 捕获点击产生的新标签页
  • 避免“先点击、后监听”导致的事件竞争问题
  • 在原页面与新页面之间分别执行断言和操作

先等待事件,再触发点击

新标签页创建是异步事件。如果先执行点击,再调用 waitForEvent(),浏览器可能已经完成页面创建,测试随后就会一直等待一个已经发生过的事件。因此应先创建等待 Promise,再执行触发动作。

下面的测试使用 page.setContent() 构造一个无需外部网站的页面。点击按钮后,浏览器通过 window.open() 打开新标签页,测试捕获对应的 Page 对象并验证内容。

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

test('获取点击打开的新标签页', async ({ page }) => {
  await page.setContent(`
    <h1>Main Page</h1>
    <button id="open">Open Docs</button>
    <script>
      document.querySelector('#open').onclick = () => {
        window.open(
          'data:text/html,%3Ctitle%3ENew%20Tab%3C%2Ftitle%3E%3Ch1%3EDocs%3C%2Fh1%3E',
          '_blank'
        );
      };
    </script>
  `);

  // 必须在点击之前开始监听,避免错过 popup 事件。
  const newPagePromise = page.waitForEvent('popup');
  await page.locator('#open').click();
  const newPage = await newPagePromise;

  await newPage.waitForLoadState('domcontentloaded');
  await expect(newPage).toHaveTitle('New Tab');
  await expect(newPage.locator('h1')).toHaveText('Docs');

  console.log(`新标签页标题: ${await newPage.title()}`);
  console.log(`新标签页正文: ${await newPage.locator('h1').textContent()}`);

  await newPage.close();
});

预期输出:

text
新标签页标题: New Tab
新标签页正文: Docs

测试运行器还会输出用例通过信息,其格式可能因 Playwright 版本、报告器和终端环境而不同。

新旧页面是两个独立的 Page

捕获新标签页后,变量 page 仍然表示原页面,newPage 表示刚创建的页面。Playwright 不要求像传统 WebDriver 那样执行全局的“切换窗口”命令;要操作哪个页面,直接调用对应 Page 对象即可。

例如,page.locator(...) 始终查询原页面,而 newPage.locator(...) 查询新标签页。即使两个页面具有相同的按钮文本或元素选择器,它们的定位范围也不会混在一起。这种对象级隔离让多页面测试更容易控制。

popup 与 context page 的选择

当新页面明确由当前页面打开时,优先使用 page.waitForEvent('popup')。它直接表达“等待这个父页面产生的新页面”,父子关系清楚,也不会误捕获同一浏览器上下文中其他页面产生的事件。

如果测试关心的是整个 BrowserContext 中出现的任意新页面,例如页面可能由无法确定的来源创建,可以改用 context.waitForEvent('page')。两种方式最终得到的都是 Page 对象,但监听范围不同。

处理页面加载边界

拿到 Page 对象并不意味着目标页面的所有资源都已经加载完成。若后续操作依赖 DOM,可以等待 domcontentloaded,或者更推荐直接等待需要操作的元素进入可用状态。Playwright 的 Locator 和断言本身带有自动等待,因此通常不必额外等待网络完全空闲。

实际项目中可以把核心顺序记成三个动作:先监听事件,触发打开动作,最后使用返回的 Page 对象。只要保持这个顺序,新标签页测试就不需要依赖固定延时,也不会因为页面创建过快而错过事件。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理新标签页

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

登录哪都通