捕获新窗口与弹出页的核心机制
在进行自动化测试或网页抓取时，经常会遇到点击某个元素后，浏览器打开一个全新的窗口（或标签页），例如第三方登录验证、文件下载确认或广告弹窗等。要与这些新打开的窗口进行交互，playwright 提供了 page.expect_popup() 方法来优雅地处理这种情况。
page.expect_popup() 的关键在于时序性：你需要在执行任何可能导致新窗口弹出的动作之前调用它。当 expect_popup() 上下文管理器被激活时，Playwright 会开始监听由当前页面触发的任何新窗口事件。一旦新窗口弹出，它就会被捕获并作为 Page 对象返回，供后续操作使用。
逐步实现新窗口处理
以下是使用 page.expect_popup() 处理新窗口的典型步骤：
-
初始化 Playwright 环境 首先，需要启动 Playwright 浏览器并创建一个新的页面实例。
from playwright.sync_api import sync_playwright, Page # 使用 with 语句确保 Playwright 资源得到正确管理 with sync_playwright() as p: # 启动 Chromium 浏览器，headless=False 表示可视化操作，slow_mo 增加操作延迟 browser = p.chromium.launch(headless=False, slow_mo=50) # 创建一个新的页面（标签页） page = browser.new_page() # ... 后续操作 -
导航至目标页面 将主页面导航到你希望开始操作的 URL。
page.goto("https://buff.163.com/market/csgo#tab=selling&page_num=1") print(f"已导航至: {page.url}") -
触发新窗口前的准备 这是最关键的一步。在执行任何可能导致新窗口弹出的点击操作之前，使用 with page.expect_popup() as popup_info: 来设置监听。popup_info 将是一个异步结果对象，它会在新窗口出现后持有该窗口的 Page 对象。
# 假设页面上有一个“登录/注册”按钮，点击后可能会弹出一个模态框或直接进入登录流程 # 根据实际页面元素调整定位器 page.get_by_role("link", name="Login/Register").click() print("已点击 '登录/注册' 按钮。") # 在点击“其他登录方式”按钮之前，准备好捕获即将弹出的新窗口。 # 这里的 with 语句确保 Playwright 监听新窗口事件。 with page.expect_popup() as popup_info: # 点击“其他登录方式”按钮，此操作会触发浏览器打开一个新窗口。 # 假设此按钮在登录模态框内。 page.get_by_text("Other login methods").click() print("已点击 '其他登录方式' 按钮，等待新窗口弹出。")注意： 优先使用 Playwright 提供的语义化定位器（如 get_by_role, get_by_text, get_by_label）来定位元素，它们比脆弱的 XPath（如 xpath=/html/body/div[1]/div/div[3]/ul/li/a）更健壮、可读性更强。
-
获取新窗口对象 一旦 with 块中的操作触发了新窗口，popup_info 就会被解析，你可以通过 popup_info.value 获取到新窗口的 Page 对象。
popup_page = popup_info.value if popup_page: print(f"成功捕获到新窗口，URL: {popup_page.url}") else: print("未能捕获到新窗口。") -
等待新窗口加载完成 新窗口可能需要一些时间来完全加载其内容。使用 popup_page.wait_for_load_state() 是一个良好的实践，确保在新窗口上执行操作之前，其 DOM 已经准备就绪。
popup_page.wait_for_load_state() print(f"新窗口标题: {popup_page.title()}") -
在新窗口中进行操作 现在，你已经拥有了新窗口的 Page 对象（即 popup_page 变量），可以像操作主页面一样，使用它来定位元素、填写表单、点击按钮等。
# 示例：在新窗口中进行操作，例如填写登录信息 # popup_page.get_by_label("Steam 账户名").fill("your_steam_username") # popup_page.get_by_label("密码").fill("your_steam_password") # popup_page.get_by_role("button", name="登录").click() print("在新窗口中进行交互...") # 完成操作后，可以根据需要选择关闭新窗口 # popup_page.close()
完整示例代码
以下是一个结合上述步骤的完整 Playwright 同步代码示例，用于处理第三方登录时弹出的新窗口：
from playwright.sync_api import sync_playwright, Page
def handle_login_popup_flow(page: Page):
"""
处理登录流程中可能弹出的新窗口。
假设页面已导航到目标URL，并且需要点击一系列按钮来触发新窗口。
"""
try:
# 1. 点击主页上的“登录/注册”按钮。
# 此操作可能弹出一个模态框，而不是新窗口。
# 请根据您的实际页面元素调整定位器。
page.get_by_role("link", name="Login/Register").click()
print("已点击主页 '登录/注册' 按钮。")
# 2. 准备捕获即将弹出的新窗口。
# 在点击“其他登录方式”按钮之前，设置 expect_popup 监听。
with page.expect_popup() as popup_info:
# 3. 点击“其他登录方式”按钮，此操作通常会触发浏览器打开一个新窗口。
# 假设此按钮在之前弹出的模态框内。
page.get_by_text("Other login methods").click()
print("已点击 '其他登录方式' 按钮，Playwright 正在监听新窗口。")
# 4. 获取新窗口的 Page 对象。
popup_page = popup_info.value
if popup_page:
print(f"成功捕获到新窗口。新窗口URL: {popup_page.url}")
# 5. 等待新窗口内容加载完成。
popup_page.wait_for_load_state()
print(f"新窗口标题: {popup_page.title()}")
# 6. 在新窗口中进行操作。
# 这里可以添加针对第三方登录页面的具体操作，例如：
# popup_page.get_by_label("用户名").fill("your_username")
# popup_page.get_by_label("密码").fill("your_password")
# popup_page.get_by_role("button", name="登录").click()
print("在新窗口中进行交互（例如填写登录信息）。")
# 完成操作后，可以根据需要关闭新窗口
# popup_page.close()
# print("新窗口已关闭。")
else:
print("未能捕获到新窗口，可能触发条件不满足或时序错误。")
except Exception as e:
print(f"处理新窗口时发生错误: {e}")
if __name__ == '__main__':
with sync_playwright() as p:
# 启动 Chromium 浏览器，非无头模式，操作延迟50毫秒
browser = p.chromium.launch(headless=False, slow_mo=50)
page = browser.new_page()
try:
# 导航到初始页面
page.goto("https://buff.163.com/market/csgo#tab=selling&page_num=1")
print(f"主页面已导航至: {page.url}")
# 调用函数处理登录弹窗流程
handle_login_popup_flow(page)
except Exception as e:
print(f"主流程执行时发生错误: {e}")
finally:
# 确保浏览器最终被关闭
browser.close()
print("浏览器已关闭。")
注意事项
- 时序性至关重要： 务必在触发新窗口弹出的动作（如 click()）之前调用 page.expect_popup()。如果顺序颠倒，Playwright 将无法监听并捕获到该事件，导致脚本失败。
- 等待加载状态： 在获取到 popup_page 对象后，使用 popup_page.wait_for_load_state() 是一个良好的实践。这能确保在新窗口的 DOM 元素完全加载并稳定后再尝试进行交互，避免因元素未加载而导致的查找失败。
- 健壮的元素定位： 避免使用过于脆弱的 XPath（如 /html/body/div[1]/div/...），这些定位器在页面结构稍有变化时就容易失效。优先使用 Playwright 提供的语义化定位器，如 get_by_role()、get_by_text()、get_by_label() 等，它们更具可读性和稳定性。
- 模态框与新窗口的区别： 有些“弹出”实际上是页面内部的模态框（Modal Dialog），它们仍然在同一个 Page 对象上，不需要 `expect
