重命名IP地址空间枚举值kPrivate为kLocal以符合LNA规范

提交: b1f71c4c | 2025-07-17 18:47:31+00:00

← 返回列表

重命名IP地址空间枚举值kPrivate为kLocal以符合LNA规范

Minor
提交哈希: b1f71c4c3453897302f3d58dee130e1171d3356c
提交时间: 2025-07-17 18:47:31+00:00
影响等级: Minor
生成工具: webview2-upstream-sentry
上游审核链接: 查看上游审核 🔗

📋 摘要

本次提交将IPAddressSpace枚举中的kPrivate重命名为kLocal,这是Local Network Access (LNA)规范重命名的一部分。将原有的PNA (Private Network Access)命名转换为LNA命名约定:PNA的private对应LNA的local。此变更涉及38个文件,包括网络服务、Service Worker、CORS处理、DevTools协议、Blink渲染引擎等多个组件。同时更新了相关的测试代码、错误字符串显示和开发者工具协议定义。保持了对旧的"private"字符串的向后兼容支持作为别名。

🎯 影响分析

对终端用户:此变更是纯内部实现的重命名,不会影响终端用户的任何功能或性能。本地网络访问的行为和安全策略保持完全一致,用户不会感知到任何变化。

对开发者:主要影响包括:1) DevTools中Network面板的IP地址空间显示从"Private"改为"Local",但这只是显示标签的变化;2) JavaScript Fetch API中targetAddressSpace参数继续支持"private"作为"local"的别名,确保现有代码继续工作;3) 网络相关的内部API签名保持不变,但枚举值名称从kPrivate更改为kLocal;4) 错误消息和调试信息中的地址空间描述从"private"变为"local"。开发者无需修改现有代码,但新代码建议使用"local"而非"private"。