Playwright 教程：高效处理浏览器新窗口与弹出页

捕获新窗口与弹出页的核心机制

在进行自动化测试或网页抓取时，经常会遇到点击某个元素后，浏览器打开一个全新的窗口（或标签页），例如第三方登录验证、文件下载确认或广告弹窗等。要与这些新打开的窗口进行交互，playwright 提供了 page.expect_popup() 方法来优雅地处理这种情况。

page.expect_popup() 的关键在于时序性：你需要在执行任何可能导致新窗口弹出的动作之前调用它。当 expect_popup() 上下文管理器被激活时，Playwright 会开始监听由当前页面触发的任何新窗口事件。一旦新窗口弹出，它就会被捕获并作为 Page 对象返回，供后续操作使用。

逐步实现新窗口处理

以下是使用 page.expect_popup() 处理新窗口的典型步骤：

1. 初始化 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()
       # ... 后续操作

   登录后复制

2. 导航至目标页面 将主页面导航到你希望开始操作的 URL。

   page.goto("https://buff.163.com/market/csgo#tab=selling&page_num=1")
   print(f"已导航至: {page.url}")

   登录后复制

3. 触发新窗口前的准备 这是最关键的一步。在执行任何可能导致新窗口弹出的点击操作之前，使用 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）更健壮、可读性更强。

   

   一览AI绘图

   一览AI绘图是一览科技推出的AIGC作图工具，用AI灵感助力，轻松创作高品质图片

   45

   查看详情

4. 获取新窗口对象 一旦 with 块中的操作触发了新窗口，popup_info 就会被解析，你可以通过 popup_info.value 获取到新窗口的 Page 对象。

   popup_page = popup_info.value
   if popup_page:
       print(f"成功捕获到新窗口，URL: {popup_page.url}")
   else:
       print("未能捕获到新窗口。")

   登录后复制

5. 等待新窗口加载完成 新窗口可能需要一些时间来完全加载其内容。使用 popup_page.wait_for_load_state() 是一个良好的实践，确保在新窗口上执行操作之前，其 DOM 已经准备就绪。

   popup_page.wait_for_load_state()
   print(f"新窗口标题: {popup_page.title()}")

   登录后复制

6. 在新窗口中进行操作 现在，你已经拥有了新窗口的 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

以上就是Playwright 教程：高效处理浏览器新窗口与弹出页的详细内容，更多请关注php中文网其它相关文章！