UD5工具箱
常见问题
什么是 PWA URL 协议处理 (Protocol Handlers)？
PWA URL 协议处理是一项允许已安装的 PWA 注册处理特定 URL 协议的功能。当用户在操作系统或浏览器中点击某个协议链接（如 web+myapp:some/path）时，系统会自动唤起对应的 PWA 来处理该链接。这需要在 manifest.json 中配置 protocol_handlers 字段。该功能在 Chrome 96+ 和 Edge 96+ 中得到支持，是 PWA 实现原生应用级体验的重要能力之一。
支持哪些 URL 协议？
目前支持的协议分为以下几类：web+ 前缀自定义协议，如 web+myapp、web+notes 等，这是专门为 Web 应用保留的自定义协议命名空间；系统预设协议，包括 mailto（邮件）、tel（电话）、sms（短信）、webcal（日历）等。部分浏览器还支持 bitcoin、ethereum 等加密货币协议。使用自定义协议时，必须以 web+ 开头。
%s 占位符是如何工作的？
%s 是 URL 模板中的占位符，会被替换为经过 URI 编码的完整协议 URL。例如，用户点击 web+myapp:path/data?id=1，该 URL 经过 encodeURIComponent() 编码后变为 web+myapp%3Apath%2Fdata%3Fid%3D1，然后替换到模板中的 %s 位置。在 PWA 内部，您需要使用 decodeURIComponent() 来还原原始 URL。这种编码机制确保了特殊字符不会破坏 URL 结构。
用户如何触发协议处理？
用户可以通过多种方式触发协议处理：点击网页中的协议链接（<a href="web+myapp:...">）、在浏览器地址栏直接输入协议 URL、从其他应用（如邮件客户端、文档编辑器）中点击协议链接、或通过操作系统的自定义 URL 方案唤起。首次触发时，浏览器会弹出确认对话框询问用户是否允许该 PWA 处理此类链接，用户确认后该协议将被注册为默认处理器。
如何在 PWA 中测试协议处理功能？
测试协议处理功能需要以下步骤：首先确保 PWA 已正确安装（需要 HTTPS 环境）；然后在 manifest.json 中配置 protocol_handlers；创建一个包含协议链接的测试页面（如 <a href="web+myapp:test">测试链接</a>）；在浏览器中点击该链接，观察是否弹出协议处理确认对话框；在 Chrome 中，可以在 chrome://settings/content/handlers 管理已注册的协议处理程序。
registerProtocolHandler API 与 manifest protocol_handlers 有什么区别？
两者都可以注册协议处理，但有以下关键区别：registerProtocolHandler 通过 JavaScript 在运行时动态注册，需要用户手势触发，注册后对所有该浏览器的访问生效（不限于 PWA）；manifest protocol_handlers 在 PWA 的 manifest 中静态声明，仅在 PWA 安装后生效，与 PWA 生命周期绑定。这是推荐的 PWA 协议处理方式。两者可以配合使用，但 protocol_handlers 是 PWA 场景下的最佳实践。
协议处理在哪些浏览器中可用？
截至 2024 年，Chrome 96+ 全面支持 manifest protocol_handlers（桌面和 Android）；Edge 96+ 支持（基于 Chromium）；Opera 82+ 支持（基于 Chromium）。Safari 目前不支持 manifest protocol_handlers，但支持部分 registerProtocolHandler 功能；Firefox 有限支持，主要通过 registerProtocolHandler。建议使用前进行浏览器兼容性检测，并提供降级方案。
如何调试协议处理问题？
调试协议处理问题可以尝试以下方法：在 Chrome 中访问 chrome://settings/content/handlers 查看已注册的协议处理程序；检查 manifest.json 中的 protocol_handlers 配置格式是否正确；确保 PWA 已正确安装（检查 Chrome DevTools > Application > Manifest）；查看浏览器控制台是否有协议处理相关的错误信息；测试时使用不同的协议链接格式，确认 URL 编码/解码逻辑正确。如果问题仍然存在，可以尝试重新安装 PWA 并清除浏览器缓存。
使用协议处理需要注意哪些安全事项？
使用 Protocol Handlers 时需要关注以下安全事项：始终验证传入的协议 URL 是否来自可信来源，防止恶意链接触发应用处理；设置 URL 白名单限制可处理的协议和路径模式，避免处理无关请求；对解码后的 URL 进行严格的输入验证和消毒处理，防止注入攻击；避免直接将协议 URL 插入 DOM 以防止 XSS 攻击；确保 PWA 和协议处理均在 HTTPS 环境下运行，保护数据传输安全。遵循这些安全最佳实践可以有效降低安全风险。