Tampermonkey中GM.xmlHttpRequest对协议相对URL的解析问题解析

问题背景

在Web开发中，协议相对URL（Protocol-relative URLs）是一种常见的URL书写方式，它省略了协议部分（如http:或https:），只以双斜杠//开头。这种URL会根据当前页面的协议自动选择使用HTTP或HTTPS协议，从而提高兼容性和安全性。

然而，在Tampermonkey 5.1.1版本中，用户报告了一个关于GM.xmlHttpRequest方法处理协议相对URL时的bug。当使用这种URL时，Tampermonkey未能正确解析URL，导致请求失败。

问题表现

当用户尝试使用如下格式的URL发起请求时：

//cdn.jsdelivr.net/npm/left-pad@1.3.0/index.min.js

Tampermonkey错误地将URL解析为：

https://npm/left-pad@1.3.0/index.min.js

可以看到，解析过程中出现了两个主要问题：

1. 域名部分cdn.jsdelivr.net被错误地截断为npm
2. 路径部分也被错误处理

这导致请求最终失败，返回状态码0，且没有有效的响应内容。

技术分析

协议相对URL的正确解析应该遵循以下规则：

1. 保留完整的域名部分
2. 根据当前页面使用的协议（HTTP或HTTPS）自动补全协议部分
3. 保持路径部分完整不变

在Tampermonkey的实现中，URL解析器在处理协议相对URL时出现了逻辑错误，可能是由于：

• 对双斜杠开头的URL特殊处理不足
• 域名解析逻辑存在缺陷
• URL拼接过程中出现了意外的字符串截断

解决方案

Tampermonkey开发团队已经在5.3.6213 beta版本中修复了这个问题。用户可以通过以下方式获取修复：

1. 下载beta版本的CRX文件
2. 在Chrome扩展页面（chrome://extensions）启用开发者模式
3. 将CRX文件拖拽安装

安装前建议先通过Tampermonkey的"Utilities"选项卡导出当前设置和脚本，安装新版本后再导入。

最佳实践

为避免类似问题，开发者在使用GM.xmlHttpRequest时可以：

1. 尽量使用完整URL（包含协议部分）
2. 如果必须使用协议相对URL，可以先通过JavaScript的URL API进行规范化处理
3. 在请求失败时添加适当的错误处理和重试逻辑

总结

URL解析是浏览器扩展开发中的基础但重要的一环。Tampermonkey团队对此问题的快速响应展示了他们对产品质量的重视。开发者在使用这类高级API时，应当注意边界条件的测试，特别是对于特殊格式的输入处理。同时，关注项目的更新动态，及时升级到修复了已知问题的版本，可以避免很多潜在的兼容性问题。