如何通过CDP事件在Nodriver中实现浏览器级全标签下载检测

问题背景 #

使用cdp.page.DownloadWillBegin事件可检测标签页内的下载启动，但无法捕获通过新标签页跳转触发的下载。尝试使用cdp.browser.DownloadWillBegin事件但未触发处理函数，需要实现覆盖当前及所有未来标签的浏览器级下载检测。

解决思路 #

1. 放弃使用cdp.browser.DownloadWillBegin（当前nodriver版本对该事件支持存在问题），改为监听浏览器的tab_added事件，实时为新创建的标签页绑定下载事件处理器。
2. 启动时为所有已存在的标签页批量绑定处理器，替代原有的轮询逻辑，减少性能消耗。
3. 使用独立命名的回调函数替代lambda表达式，避免闭包变量捕获导致的事件触发异常。

修改后的完整代码 #

import asyncio
import nodriver as uc
from nodriver import cdp

async def handle_download(event):
    print(f'Download event => {event.guid}')

async def bind_tab_handlers(tab):
    # 为单个标签页绑定下载事件处理器
    await tab.add_handler(cdp.page.DownloadWillBegin, handle_download)

async def setup_global_download_listener(browser):
    # 为已存在的所有标签页绑定处理器
    for tab in browser.tabs:
        await bind_tab_handlers(tab)
    # 监听新标签页创建事件，自动绑定处理器
    async for new_tab in browser.tab_added:
        await bind_tab_handlers(new_tab)

async def crawl():    
    browser = await uc.start(headless=False)
    # 启动全局监听任务
    asyncio.create_task(setup_global_download_listener(browser))

    # 测试下载链接
    await browser.get("https://www.python.org/ftp/python/3.13.0/python-3.13.0-amd64.exe")
    await browser.get("https://code.visualstudio.com/sha/download?build=stable&os=win32-x64-user", new_tab=True)

    while True:
        await asyncio.sleep(0.2)  # 保持事件循环运行

if __name__ == '__main__':
    uc.loop().run_until_complete(crawl())

关键改进点 #

• 事件驱动替代轮询：利用browser.tab_added异步迭代器，在新标签页创建时立即绑定处理器，无需定时轮询检查标签页状态。
• 规避闭包陷阱：使用独立的handle_download函数作为回调，确保每个标签页的下载事件能正确触发并执行处理逻辑。
• 全量初始覆盖：启动时一次性为所有已加载的标签页绑定处理器，保证初始状态下所有标签的下载事件都能被捕获。

内容的提问来源于stack exchange，提问作者Abhash Rai