Violentmonkey插件中GM.setValue在Firefox 130版本的异常行为分析

问题现象

在Violentmonkey浏览器插件版本2.21至2.23中，用户报告了一个关于GM.setValue API在Firefox 130版本上的异常行为。具体表现为当尝试存储数据时，Promise无法正常解析，导致后续代码无法执行。这一现象在存储不同值或较长字符串时尤为明显。

技术细节分析

GM.setValue是Violentmonkey提供的一个核心API，用于在用户脚本中持久化存储数据。正常情况下，该API返回一个Promise，在数据成功存储后会解析(resolve)。但在受影响版本中，出现了以下异常情况：

1. 首次存储行为：当首次使用GM.setValue存储某个键值时，操作可以成功完成，但Promise不会解析
2. 后续存储行为：尝试修改已存在的键值时，Promise完全不会解析，代码执行在此处停止
3. 数据类型影响：短字符串、布尔值和数字受影响较小，而长字符串更容易触发此问题

问题根源

经过分析，这个问题与Violentmonkey内部处理Promise的方式有关。在2.21至2.23版本中，当GM.setValue需要实际执行存储操作时返回的Promise存在解析机制缺陷。具体表现为：

• 当存储的值与现有值相同时，操作可能绕过Promise机制直接完成
• 当需要实际修改存储内容时，返回的Promise无法正常解析
• 这一问题在Firefox 130上表现尤为明显，可能与浏览器对Promise实现的细微变化有关

解决方案

该问题已在Violentmonkey 2.24.0版本中得到修复。对于无法立即升级的用户，可以考虑以下临时解决方案：

1. 添加超时处理：对GM.setValue操作包装超时逻辑，避免脚本完全卡死
2. 简化存储数据：尽量避免存储过长的字符串，将大数据拆分为多个小块
3. 使用try-catch：虽然Promise不解析时不会抛出异常，但可以捕获其他可能的错误

最佳实践建议

为避免类似问题，建议用户脚本开发者：

1. 始终对存储操作添加错误处理逻辑
2. 考虑为关键存储操作添加超时机制
3. 定期检查Violentmonkey的版本更新
4. 在可能的情况下，对重要数据进行本地验证，确保存储操作确实完成

总结

这个案例展示了浏览器扩展开发中可能遇到的微妙兼容性问题。即使是经过充分测试的API，在特定浏览器版本或环境下也可能出现意外行为。对于依赖Violentmonkey进行开发的用户脚本作者来说，理解这些边界情况并采取防御性编程策略至关重要。