自动化测试 / 系统课时
处理新窗口
处理新窗口
浏览器把 window.open() 的结果显示为独立窗口还是标签页,可能受浏览器模式和运行环境影响,但 Playwright 都将它表示为新的 Page。因此处理父子窗口的关键不是操作系统窗口焦点,而是保存父页面和弹出页面各自的 Page 对象,并针对正确对象执行操作。
学习目标
- 监听父页面产生的弹出窗口并取得子页面对象
- 理解 Playwright 中父子页面之间的关联方式
- 在父页面和子页面之间可靠地执行定位、断言与关闭操作
捕获父页面打开的子窗口
对于由当前页面调用 window.open() 创建的窗口,可以监听当前 page 的 popup 事件。等待动作仍然必须在点击之前注册,否则存在错过事件的风险。
下面的完整测试创建一个父页面,并通过带窗口尺寸参数的 window.open() 打开子页面。无论浏览器最终把它呈现成独立窗口还是标签页,Playwright 的操作方式都相同。
import { test, expect } from '@playwright/test';
test('在父页面和弹出窗口之间操作', async ({ page }) => {
await page.setContent(`
<title>Parent Window</title>
<h1>Parent</h1>
<button id="open-child">Open Child</button>
<script>
document.querySelector('#open-child').onclick = () => {
window.open(
'data:text/html,%3Ctitle%3EChild%20Window%3C%2Ftitle%3E%3Ch1%3EChild%3C%2Fh1%3E',
'child-window',
'width=480,height=320'
);
};
</script>
`);
// 先监听,再执行真正会创建子页面的点击操作。
const childPagePromise = page.waitForEvent('popup');
await page.locator('#open-child').click();
const childPage = await childPagePromise;
await childPage.waitForLoadState('domcontentloaded');
await expect(childPage.locator('h1')).toHaveText('Child');
// opener() 可用于确认这个页面确实由当前父页面创建。
const opener = await childPage.opener();
expect(opener).toBe(page);
console.log(`子页面标题: ${await childPage.title()}`);
await expect(page.locator('h1')).toHaveText('Parent');
console.log(`父页面标题: ${await page.title()}`);
await childPage.close();
});预期输出:
子页面标题: Child Window
父页面标题: Parent Window测试运行器自身的通过信息可能因报告器配置不同而变化,但上面两行由示例代码直接输出,顺序保持一致。
Playwright 不需要 switchTo
传统浏览器自动化工具常要求先切换全局窗口句柄,再定位元素。Playwright 的模型不同:每一个页面都是独立 Page 实例,因此所谓“切换到子窗口”,实际就是开始使用 childPage;返回父窗口,则继续使用原来的 page。
这种方式尤其适合父子页面同时存在的场景。测试可以先在子页面读取订单号,再回到父页面填写结果,而无需维护一个不断变化的全局当前窗口状态。只要变量命名清楚,就能直接看出每一步正在操作哪个页面。
什么时候需要 bringToFront
page.bringToFront() 可以让某个页面成为浏览器前台页面,但大多数自动化操作并不需要它。Locator、点击和断言针对的是指定的 Page 对象,而不是屏幕上当前可见的窗口。
只有在 headed 模式调试、录制人工观察过程,或页面逻辑确实依赖前台激活状态时,才有必要考虑 bringToFront()。把它当成常规“窗口切换”操作反而会增加不必要的测试步骤。
防止捕获错误的窗口
一个点击有时会产生多个页面,例如先打开身份验证窗口,再由脚本打开业务页面。此时仅等待一次 popup 可能不足以判断拿到的是哪个页面。可以在取得页面后根据 URL、标题或关键元素做明确验证,再继续业务操作。
如果新页面并非确定由当前父页面创建,而是浏览器上下文中的其他流程触发,应把监听范围提升到 BrowserContext,使用 context.waitForEvent('page')。反过来,已知父页面时继续使用 page.waitForEvent('popup'),可以缩小事件范围并减少误匹配。
当弹出页面完成任务后应及时调用 close(),尤其是一个测试会反复创建窗口时。这样既能避免残留页面干扰后续事件监听,也能让测试中的页面生命周期与真实业务步骤保持一致。