Tampermonkey中GM_download下载二进制文件被错误编码的问题分析

问题背景

在Tampermonkey浏览器扩展的beta版本中，用户报告了一个关于GM_download API处理二进制文件下载的问题。当脚本尝试下载PNG图片等二进制文件时，文件内容会被错误地重新编码为UTF-8文本格式，导致下载的文件无法正常使用。

问题现象

用户通过以下简单脚本测试下载Tampermonkey官网的图标：

GM_download('https://www.tampermonkey.net/images/icon48.png', 'icon48.png');

预期结果：下载的PNG图片应能正常显示，大小为原始二进制数据。

实际结果：

1. 下载的文件大小比原始文件大45%
2. 文件内容被重新编码为UTF-8文本格式
3. 图片无法正常显示，呈现空白

技术分析

这个问题涉及到浏览器扩展如何处理二进制数据下载的几个关键方面：

1. 二进制数据与文本数据的区别：

   • 二进制数据（如图片）需要保持原始字节序列不变
   • 文本数据（如UTF-8）会进行特定编码转换

2. GM_download API的实现：

   • 该API本应保持数据的原始格式
   • 错误版本中对所有数据强制进行了UTF-8编码转换

3. Chromium扩展机制：

   • 扩展与浏览器内核间的数据传输需要特殊处理
   • 二进制数据需要明确标记为ArrayBuffer或Blob类型

影响范围

• 浏览器版本：Chromium 125和128
• Tampermonkey版本：beta 5.2.6195和5.2.6196
• 操作系统：Windows 10

解决方案

Tampermonkey开发团队迅速响应，在5.2.6197 beta版本中修复了此问题。修复的关键点包括：

1. 正确识别响应数据的MIME类型
2. 对二进制数据保持原始格式不进行编码转换
3. 确保下载流程中数据完整性

开发者建议

对于Tampermonkey脚本开发者：

1. 使用GM_xmlhttpRequest替代GM_download处理二进制文件时，确保设置responseType: "blob"
2. 对于关键功能，建议在脚本中加入版本检测和兼容性处理
3. 测试脚本时，应验证下载文件的MD5/SHA校验和确保数据完整性

总结

这个案例展示了浏览器扩展开发中处理二进制数据时常见的陷阱。Tampermonkey团队快速响应并修复问题，体现了对产品质量的重视。对于用户和开发者而言，及时更新到修复版本(5.2.6197+)即可解决此问题。