本文详解如何让含换行编码逻辑（如 %0A）的 JavaScript 代码同时在浏览器控制台和 Bookmarklet 中稳定运行，通过 decodeURI('%250A') 实现 URL 编码与执行环境的双重兼容。
本文详解如何让含换行编码逻辑（如 `%0a`）的 javascript 代码同时在浏览器控制台和 bookmarklet 中稳定运行，通过 `decodeuri('%250a')` 实现 url 编码与执行环境的双重兼容。
在开发调试型 Bookmarklet 时，一个常见却棘手的问题是：同一段包含换行符编码（如 %0A）的 JavaScript 代码，在浏览器控制台中可直接执行，但转为 Bookmarklet 后却因解析错误而中断。根本原因在于——Bookmarklet 的 URL 上下文会将原始字符串中的 %0A 视为实际换行符（即 \n），导致 JavaScript 引擎在解析阶段就遇到非法换行，触发语法错误（如 Unexpected token ILLEGAL）。而控制台执行的是纯 JS 字符串，不经过 URL 解码预处理，因此 %0A 被当作普通字面量保留，后续 encodeURIComponent 或 fetch 发送时才被正确解释为换行。
✅ 正确解法：用 decodeURI('%250A') 实现环境无感换行
核心思路是：避免在 Bookmarklet 字符串中直接出现 %0A，改用其双重编码形式 %250A（即 % 编码为 %25），再通过 decodeURI() 在运行时动态还原为 %0A。这样既绕过了 Bookmarklet 的早期换行解析，又保证了最终发送给后端的参数仍为标准的 URL 编码换行符。
以下是优化后的 encodifyText 函数（已整合进完整 Bookmarklet 结构）：
javascript:(async function(){
// ...（其余变量初始化逻辑保持不变）
var encodifyText = function(txt){
const lines = txt.split('\n');
let result = '';
const newlineEncoded = decodeURI('%250A'); // ← 关键：运行时解码为 '%0A'
for (let i = 0; i < lines.length; i++) {
result += encodeURIComponent(lines[i]) + newlineEncoded;
}
// 安全移除末尾换行符：使用 lastIndexOf 避免硬编码长度（如 -3 不可靠）
return result.slice(0, result.lastIndexOf(newlineEncoded));
};
// ...（后续 fetch 调用逻辑不变，body 中直接使用 encodifyText(textToInsert)）
var changeMessageFunc = async function(){
const response = await fetch('https://needed.site/api/sendIM', {
headers: {
'content-type': 'application/x-www-form-urlencoded',
'accept': '*/*'
},
method: 'POST',
body: 't=' + encodeURIComponent(currentChatId)
+ '&message=' + encodifyText(textToInsert)
+ '&updateMsgId=' + msgIdInChange
+ '&f=json&aimsid=' + encodeURIComponent(myToken),
mode: 'cors',
credentials: 'omit'
});
};
await changeMessageFunc();
})();⚠️ 注意事项与最佳实践
- 不要用 '%250A' 字面量直接拼接：若写成 '...%250A'，则 fetch 会将其作为字符串发送，后端收到的是字面 %250A，而非换行符。必须经 decodeURI('%250A') 运行时转义。
- 避免 slice(0, -3) 硬删除：原答案中 returnVal.slice(0,-3) 假设 %0A 恒为 3 字符，但 decodeURI('%250A') 返回的是 %0A（3 字符），而若未来换行符编码方式变化（如用 %0D%0A），该逻辑将失效。使用 lastIndexOf(newlineEncoded) 更健壮。
- 严格校验 DOM 元素存在性：生产环境中应添加 if (!targetNode || !targetNode.innerText) 等防护，防止因编辑态未激活导致脚本静默失败。
- Bookmarklet 长度限制提醒：Chrome 对 Bookmarklet URL 长度限制约 64KB；若逻辑复杂，建议将核心逻辑注入页面 script 标签执行，Bookmarklet 仅作加载器。
✅ 总结
decodeURI('%250A') 是解决 Bookmarklet 与控制台双环境兼容换行编码问题的最小可行方案：它利用了 URL 编码层级与 JS 执行层级的分离特性——在 URL 层以安全形式 %250A 存在，规避解析错误；在 JS 层即时还原为语义正确的 %0A，保障 API 通信完整性。此模式同样适用于其他易被 URL 解析器误判的特殊字符（如 %23 → #），是编写高可靠性 Bookmarklet 的关键技巧之一。
