Violentmonkey 中 Firefox 下 ArrayBuffer 请求发送失败问题分析

问题背景

在 Violentmonkey 用户脚本开发中，开发者发现当尝试通过 GM.xmlHttpRequest 发送 ArrayBuffer 或 Uint8Array 类型的数据时，在 Firefox 浏览器中会出现请求失败的情况。具体表现为：

1. 当数据为 Uint8Array 时，控制台报错："Error: String contains an invalid character"
2. 当数据为 ArrayBuffer 时，控制台报错："Error: a.indexOf is not a function"

技术分析

问题根源

经过深入分析，发现问题的核心在于 Violentmonkey 的请求处理逻辑中存在一个条件判断错误。在 Firefox 浏览器环境下，当需要发送二进制数据时，代码会检查浏览器版本是否大于等于 56（Firefox 56 开始支持某些特定的二进制数据处理方式）。

然而，在部分情况下，版本检查变量 IS_FIREFOX 没有被正确初始化为实际的 Firefox 版本号，而是保持为布尔值 true。这导致版本检查表达式 IS_FIREFOX >= 56 始终无法通过，进而触发了错误的数据处理路径。

影响范围

该问题主要影响以下场景：

• 使用 Firefox 浏览器
• 在 HTTP 协议（非 HTTPS）的网站上运行用户脚本
• 尝试通过 GM.xmlHttpRequest 发送 ArrayBuffer 或 Uint8Array 类型数据

临时解决方案

对于遇到此问题的开发者，可以采取以下临时解决方案：

1. 在用户脚本元数据中添加 @inject-into content 指令，强制使用内容脚本注入模式
2. 将二进制数据转换为 Base64 字符串形式发送

技术细节

正确的数据处理逻辑

在正常情况下，当检测到 Firefox 56+ 版本时，Violentmonkey 应该将二进制数据包装为 [data] 数组形式发送。这种处理方式能够确保二进制数据被正确传输。

错误的数据处理路径

当版本检查失败时，代码错误地将数据包装为 [data, 'bin'] 形式。这种格式在 Firefox 中无法被正确处理，导致了上述错误信息的出现。

开发者建议

对于用户脚本开发者，在处理二进制数据请求时，建议：

1. 始终测试脚本在不同浏览器下的兼容性
2. 对于关键功能，考虑提供多种数据发送方式的备选方案
3. 关注 Violentmonkey 的版本更新，及时获取问题修复

总结

这个案例展示了浏览器扩展开发中版本兼容性处理的重要性。即使是简单的条件判断错误，也可能导致功能完全失效。Violentmonkey 团队已经确认了这个问题，并将在后续版本中修复。在此期间，开发者可以采用上述临时解决方案确保脚本的正常运行。