1. 理解Playwright中的新窗口与弹窗
在web自动化测试中，经常会遇到点击某个链接或按钮后，浏览器会弹出一个新的窗口（tab或独立的window）来显示内容，例如第三方登录页面、支付确认页面或帮助文档等。playwright将这些由当前页面操作触发的新浏览器上下文（通常是新的tab）统称为“popup”。
默认情况下，Playwright的Page对象只会控制其自身的浏览器上下文。当一个新的窗口弹出时，我们需要一种机制来“捕获”并切换到这个新的Page对象，才能对其进行后续的交互操作。
2. 使用page.expect_popup()处理新窗口
Playwright提供了page.expect_popup()方法，它是一个上下文管理器，用于等待并捕获由其内部操作触发的新窗口。这是处理弹窗最推荐和最可靠的方式。
其基本工作原理是：
- 在执行可能触发新窗口的操作之前，调用page.expect_popup()。
- 将触发新窗口的操作代码放置在with page.expect_popup() as popup_info:块中。
- 一旦新窗口弹出，popup_info.value将返回一个代表新窗口的Page对象。
- 之后，所有的操作都将通过这个新的Page对象（例如命名为popup_page）来执行。
2.1 示例：处理第三方登录弹窗
以下代码演示了如何在一个网站上点击登录按钮，然后选择“其他登录方式”后，捕获并与新弹出的登录窗口进行交互。
from playwright.sync_api import sync_playwright
def handle_new_window_example():
with sync_playwright() as p:
# 1. 启动浏览器，headless=False以便观察操作过程
# slow_mo参数用于减慢操作速度，便于观察
browser = p.chromium.launch(headless=False, slow_mo=50)
page = browser.new_page()
# 2. 导航到目标URL
# 这里使用一个假设的URL，您可以替换为实际需要测试的页面
page.goto("https://buff.163.com/market/csgo#tab=selling&page_num=1")
print(f"当前主页面标题: {page.title()}")
# 3. 点击触发登录流程的入口按钮
# 假设页面上有一个“Login/Register”链接
page.get_by_role("link", name="Login/Register").click()
print("点击 'Login/Register' 按钮，等待登录模态框出现...")
# 4. 使用 page.expect_popup() 捕获新窗口
# 确保触发弹窗的动作（例如点击“其他登录方式”）发生在这个上下文管理器内部
with page.expect_popup() as popup_info:
# 在登录模态框中，点击“Other login methods”按钮，此操作会触发一个新窗口/Tab
page.get_by_text("Other login methods").click()
print("点击 'Other login methods' 按钮，等待新窗口弹出...")
# 5. 获取新弹出的 Page 对象
# popup_info.value 会返回代表新窗口的 Page 对象
popup_page = popup_info.value
if popup_page:
print("新窗口已成功捕获。")
# 6. 等待新窗口加载完成
# 推荐等待 DOMContentLoaded 或 load 状态，确保页面内容已准备好交互
popup_page.wait_for_load_state("domcontentloaded")
print(f"新窗口标题: {popup_page.title()}")
print(f"新窗口URL: {popup_page.url}")
# 7. 在新窗口中执行操作
# 例如，定位并输入用户名密码，或点击确认按钮
# 以下为示例操作，请根据实际新窗口的元素进行调整
# popup_page.locator("#steamAccountName").fill("your_steam_username")
# popup_page.locator("#steamPassword").fill("your_steam_password")
# popup_page.get_by_role("button", name="Sign in").click()
# 示例：在新窗口中等待几秒以便观察
popup_page.wait_for_timeout(3000)
# 8. 完成操作后，可以选择关闭新窗口
popup_page.close()
print("新窗口已关闭。")
else:
print("未捕获到新窗口，请检查触发逻辑或超时设置。")
# 示例：在新窗口操作完成后，主页面可能需要继续操作
page.wait_for_timeout(2000)
browser.close()
print("浏览器已关闭。")
if __name__ == "__main__":
handle_new_window_example()3. 注意事项与最佳实践
- 时序问题是关键：page.expect_popup()必须在触发弹窗的动作之前调用，并且触发动作必须包含在with块中。如果先执行了触发动作，再尝试等待弹窗，那么弹窗可能已经出现并被Playwright忽略了。
- 等待加载状态：捕获到popup_page后，立即对其执行popup_page.wait_for_load_state()是非常重要的。这可以确保新窗口的内容已经加载完毕，避免在元素尚未出现时就尝试定位而导致失败。常用的状态有"load"、"domcontentloaded"和"networkidle"。
- 独立的Page对象：popup_page是一个全新的Page对象，它有自己独立的上下文。对其进行的所有操作（如goto、locator、click等）都只会影响这个新窗口，不会影响原来的主页面page对象。
- 超时处理：expect_popup()默认有30秒的超时时间。如果在这个时间内没有新窗口弹出，它会抛出异常。您可以通过page.expect_popup(timeout=...)来调整超时时间。
- 多个弹窗：如果一个操作会连续触发多个新窗口，您需要为每个弹窗独立使用page.expect_popup()。
- 关闭弹窗：在对新窗口完成操作后，如果不再需要它，建议调用popup_page.close()来关闭它，以释放资源并保持浏览器状态整洁。
- 无头模式兼容性：page.expect_popup()在无头（headless）模式下同样有效，即使您看不到实际的浏览器窗口，Playwright也能正确捕获并处理弹窗。
4. 总结
page.expect_popup()是Playwright处理新窗口和弹窗场景的核心机制。通过正确地使用它，您可以有效地捕获、切换并与这些动态生成的浏览器上下文进行交互，从而实现对复杂Web应用的全面自动化测试。掌握这一技术，对于构建健壮和可靠的Playwright自动化测试脚本至关重要。始终记住，关键在于确保触发弹窗的动作发生在expect_popup的上下文管理器的作用域内，并等待新窗口内容加载完成再进行操作。
