Tampermonkey中处理GM_Download文件名非法字符的技术方案

问题背景

在Tampermonkey脚本开发中，使用GM_Download下载文件时经常会遇到文件名包含非法字符的问题。这些非法字符不仅包括Windows系统保留字符（如*/:<>?|等），还可能包含各种Unicode控制字符和特殊符号。当文件名包含这些字符时，GM_Download会抛出错误导致下载失败。

常见非法字符类型

1. 系统保留字符：包括*/:<>?|等Windows/Linux系统文件名保留字符
2. 控制字符：ASCII码0-31的控制字符（如\u0000-\u001F）
3. 特殊Unicode字符：
   • 零宽空格（\u200B）
   • 表情符号连接符（\u200D）
   • 代理对字符（\uD800-\uDB7F和\uDC00-\uDFFF）
4. 非打印字符：ASCII码127的删除字符（\u007F）

解决方案

基础字符过滤方案

可以使用正则表达式来过滤掉这些非法字符：

const badChars = /[\u0000-\u001F"*/:<>?\\|\u007F\u200B]|[\u200D\uD800-\uDB7F\uDC00-\uDFFF]+|\.+\s*$/g;
let safeName = originalName.replace(badChars, "_").trim();

这个正则表达式会：

1. 替换所有控制字符和系统保留字符
2. 处理零宽空格和表情符号连接符
3. 移除文件名末尾的点号

增强版ASCII字符过滤

对于更严格的过滤，可以只保留可打印的ASCII字符：

function sanitizeFilename(input) {
    // 只保留ASCII码32-126的可打印字符
    return input.replace(/[^\u0020-\u007E]/g, "_");
}

错误处理机制

建议实现一个完整的错误处理流程：

async function safeDownload(url, filename) {
    try {
        await GM_download(url, filename);
    } catch (ex) {
        if (ex?.error === "not_whitelisted") {
            // 扩展名不在白名单错误处理
        } else if (ex?.error === "not_succeeded") {
            // 下载失败处理
        } else if (!("error" in ex)) {
            // 文件名非法字符错误处理
            const newName = prompt(`文件名"${filename}"包含非法字符`, filename) || 
                          filename.replace(/[^\u0020-\u007E]/g, "_");
            return safeDownload(url, newName); // 重试
        }
    }
}

最佳实践建议

1. 预处理文件名：在调用GM_Download前先对文件名进行清理
2. 保留原始信息：虽然替换特殊字符，但尽量保持文件名可读性
3. 用户交互：对于重要文件，可以提供交互式修复选项
4. 日志记录：记录原始文件名和处理后的文件名，便于调试
5. 统一处理：将文件名处理逻辑封装成公共函数，确保一致性

总结

处理GM_Download文件名中的非法字符是Tampermonkey脚本开发中的常见需求。通过合理的字符过滤和错误处理机制，可以大大提高脚本的健壮性。开发者应根据实际需求选择合适的过滤策略，平衡安全性和可用性。对于关键任务脚本，建议实现完整的错误处理流程，确保在遇到非法字符时能够优雅降级或提供修复选项。