Chrome扩展中onDeterminingFilename监听干扰所有下载问题求解决

问题根因 #

你的问题核心出在chrome.downloads.onDeterminingFilename的API使用逻辑不符合Chrome规范：只要注册了该事件的监听器，所有经过Chrome的下载请求都必须在监听器回调中调用suggest()方法。你当前的代码只在匹配到B类文件时才调用suggest()，非B类文件（包括你自己发起的A类下载、用户主动的下载、其他扩展的下载）没有触发suggest()调用，Chrome会直接忽略你通过chrome.downloads.download接口传入的filename参数，默认使用原始文件名，这就是你所有下载都无法自定义命名的原因。

可行解决方案 #

方案1：补全监听器默认分支（最推荐） #

只需要在监听器中增加默认分支，非B类下载时直接调用空参数的suggest()即可，Chrome会自动沿用原有文件名配置（包括A类下载传入的filename参数、用户主动下载的默认文件名），不会产生任何干扰。
同时建议用Map维护待处理B类文件队列，避免并发下载时单个item变量被覆盖的问题，修正后代码如下：

// 全局维护待修改文件名的B类下载队列，key为下载URL，value为目标文件名
const pendingBDownloads = new Map();

// A类下载逻辑无需修改
chrome.downloads.download({
  url: item.imageLink,
  filename: setName
});

// B类下载触发逻辑，先存入队列再发起下载
function startBDownload(bUrl, targetName) {
  pendingBDownloads.set(bUrl, targetName);
  // 调用B类专属直链下载触发逻辑
  chrome.downloads.download({url: bUrl});
}

// 修正后的文件名监听逻辑
chrome.downloads.onDeterminingFilename.addListener((downloadItem, suggest) => {
  const targetName = pendingBDownloads.get(downloadItem.url);
  if (targetName) {
    // 匹配到B类下载，修改文件名
    suggest({
      filename: targetName,
      conflictAction: "uniquify"
    });
    // 处理完成后移除队列项
    pendingBDownloads.delete(downloadItem.url);
  } else {
    // 非B类下载，直接调用suggest沿用原有配置
    suggest();
  }
});

该方案完全不会干扰用户和其他扩展的下载任务，也支持多文件并发下载的场景。

方案2：给B类下载加专属标识 #

如果存在B类下载URL重复的场景，可以在触发B类下载时给URL追加专属的查询参数作为标识，完全避免误判：

// 触发B类下载时追加专属标识参数
const bUrlWithFlag = `${originalBUrl}?ext_custom_name_flag=1`;
pendingBDownloads.set(bUrlWithFlag, targetName);
chrome.downloads.download({url: bUrlWithFlag});

// 监听器优先匹配专属标识
chrome.downloads.onDeterminingFilename.addListener((downloadItem, suggest) => {
  if (!downloadItem.url.includes('ext_custom_name_flag=1')) {
    suggest();
    return;
  }
  // 后续B类文件名处理逻辑
});

该方案的匹配精度更高，不会和其他同源的下载请求产生冲突。

内容的提问来源于stack exchange，提问作者Emu_Flock