Chrome扩展开发：如何避免重复请求保存已加载内容？

嘿，我懂你碰到的这个问题——用chrome.downloads.download()去保存已经下载完成的文件，确实会多发起一次请求，完全没必要。咱们直接利用Chrome下载管理器里已完成文件的本地路径来操作就行，不用重复消耗带宽。下面给你具体的解决方案：

核心思路 #

通过chrome.downloads.search()找到已完成的目标下载项，获取它的本地文件路径，再通过文件系统API把文件复制/移动到你想要的目录下，全程不会发起新的下载请求。

步骤1：配置扩展权限 #

首先在你的manifest.json里添加必要的权限，这样才能访问下载记录和文件系统：

{
  "manifest_version": 3,
  "name": "你的下载保存扩展",
  "version": "1.0",
  "permissions": ["downloads", "fileSystem"],
  "host_permissions": ["<all_urls>"]
}

如果用的是Manifest V2，把manifest_version改成2，权限写法基本一致。

步骤2：搜索已完成的下载项并操作文件 #

下面是完整的代码示例，假设你要根据目标URL找到已下载的文件，然后保存到extdown/目录下：

// 替换成你要处理的目标文件URL
const targetFileUrl = "https://example.com/your-target-file.png";
// 替换成你想要的目标文件名
const targetFilePath = "extdown/my-saved-file.png";

// 搜索已完成的匹配下载项
chrome.downloads.search({
  url: targetFileUrl,
  state: "complete"
}, (downloadItems) => {
  if (downloadItems.length === 0) {
    console.log("没找到对应已完成的下载记录");
    return;
  }

  // 取第一个匹配的下载项（如果有多个，可根据文件名、时间等筛选）
  const completedDownload = downloadItems[0];
  const sourceLocalPath = completedDownload.filePath;

  // 先获取Chrome默认下载目录的访问权限
  chrome.fileSystem.getDirectoryEntry({ path: "downloads", create: false }, (downloadDir) => {
    // 获取源文件的文件入口
    chrome.fileSystem.getFileEntry({ path: sourceLocalPath }, (sourceFileEntry) => {
      // 创建目标目录（extdown），不存在则自动创建
      downloadDir.getDirectory("extdown", { create: true }, (targetDir) => {
        // 从文件名里提取最后一部分（因为路径已经包含extdown目录）
        const targetFileName = targetFilePath.split("/")[1];
        // 复制源文件到目标目录
        sourceFileEntry.copyTo(targetDir, targetFileName, (copiedEntry) => {
          console.log("文件保存成功！路径：", copiedEntry.fullPath);
        }, (err) => {
          console.error("复制文件失败：", err);
        });
      }, (err) => {
        console.error("创建extdown目录失败：", err);
      });
    }, (err) => {
      console.error("获取源文件入口失败：", err);
    });
  }, (err) => {
    console.error("访问下载目录失败：", err);
  });
});

额外场景：监听下载完成事件自动保存 #

如果你的需求是在文件刚下载完成时就自动保存到指定目录，可以监听chrome.downloads.onChanged事件，实时捕获完成状态的下载项：

chrome.downloads.onChanged.addListener((downloadDelta) => {
  // 只处理状态变为complete的下载项
  if (downloadDelta.state?.current === "complete") {
    chrome.downloads.search({ id: downloadDelta.id }, (downloadItems) => {
      const completedDownload = downloadItems[0];
      console.log("刚完成的下载文件路径：", completedDownload.filePath);
      // 这里可以复用上面的文件复制逻辑，把文件转到extdown目录
    });
  }
});

关键说明 #

• 为什么不用chrome.downloads.download()？因为这个API的核心是发起新的HTTP请求去获取资源，不管资源是否已经下载过，所以会重复请求。我们的方案直接操作本地已存在的文件，完全避免了这个问题。
• 注意不同操作系统的文件路径格式差异，Chrome的filePath字段会自动适配系统路径，不用手动处理。

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