为 Page.navigate 添加下载检测功能

Moderate

提交哈希: 743aa3c7b9eddf0787f93ee2e2388cc71dea5d09

提交时间: 2025-07-16 22:20:51+00:00

影响等级: Moderate

生成工具: webview2-upstream-sentry

📋 摘要

本次提交为 Chrome DevTools Protocol (CDP) 的 Page.navigate 命令添加了新的 isDownload 字段，用于标识导航是否转变为下载。该功能解决了开发者在使用 CDP 时无法区分 "net::ERR_ABORTED" 错误是由于下载还是其他原因导致的问题。在此变更之前，开发者需要等待 Browser.downloadWillBegin 事件来确认下载，但该事件可能在 Page.navigate 返回之后才触发，造成不必要的等待。新增的 isDownload 标志允许开发者立即识别导航是否因下载而中止，提高了自动化测试和网页抓取工具的效率。

🎯 影响分析

**对终端用户的影响：**
此变更对终端用户的浏览体验没有直接影响，因为它仅涉及开发者工具协议的内部实现，不会改变用户界面或浏览器的下载行为。

**对开发者的影响：**
1. **自动化测试改进**：使用 CDP 进行网页自动化测试的开发者现在可以立即识别导航是否因下载而失败，无需等待额外的事件，提高测试执行效率
2. **网页抓取优化**：网页抓取工具可以更快速地处理下载链接，避免不必要的超时等待
3. **错误处理增强**：开发者可以更精确地区分不同类型的导航失败，提供更准确的错误处理逻辑
4. **API 向后兼容**：新字段为实验性可选字段，不会破坏现有的 CDP 客户端代码
5. **调试便利性**：DevTools 用户在调试涉及下载的页面时可以获得更清晰的反馈信息

该功能特别对使用 Puppeteer、Selenium 等基于 CDP 的自动化工具的开发者有重要价值，能够显著改善处理下载场景的用户体验。

受影响的类:

PageHandler NavigationRequest