自动化测试 / 系统课时
处理新标签页
处理新标签页
点击链接后如果站点通过 target="_blank" 或 window.open() 打开新标签页,原来的 page 不会自动变成新页面。正确做法是在触发点击之前开始等待 popup 事件,拿到新的 Page 对象后,再对它执行定位、断言和关闭操作。
学习目标
- 使用
page.waitForEvent('popup')捕获点击产生的新标签页 - 避免“先点击、后监听”导致的事件竞争问题
- 在原页面与新页面之间分别执行断言和操作
先等待事件,再触发点击
新标签页创建是异步事件。如果先执行点击,再调用 waitForEvent(),浏览器可能已经完成页面创建,测试随后就会一直等待一个已经发生过的事件。因此应先创建等待 Promise,再执行触发动作。
下面的测试使用 page.setContent() 构造一个无需外部网站的页面。点击按钮后,浏览器通过 window.open() 打开新标签页,测试捕获对应的 Page 对象并验证内容。
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();
});预期输出:
新标签页标题: 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 对象。只要保持这个顺序,新标签页测试就不需要依赖固定延时,也不会因为页面创建过快而错过事件。