Firefox自动写入文件插件失效问题排查及实现咨询

一、调试方法 #

• 启用后台脚本控制台：在Firefox地址栏输入about:debugging#/runtime/this-firefox，找到你的插件点击「检查」，打开后台脚本的控制台，可直接查看日志与报错信息。
• 捕获全局错误：在background.js开头添加全局错误监听，避免遗漏未被catch捕获的异常：

  browser.runtime.onError.addListener((err) => console.error('Runtime error:', err));
  

• 验证触发时机：原代码使用browser.runtime.onStartup仅在浏览器启动时触发，测试阶段建议改用点击插件图标触发逻辑，避免重启浏览器的麻烦。

二、代码修复（核心问题解决） #

1. 修正manifest.json #

原权限与后台配置存在错误，调整后如下：

{
  "name": "My Auto-Writer Addon",
  "version": "1.0",
  "description": "An addon that automatically writes a string to a file every 10 seconds.",
  "manifest_version": 2,
  "icons": {
    "48": "icon.png"
  },
  "permissions": ["downloads"],
  "background": {
    "scripts": ["background.js"],
    "persistent": true // 定时任务需保持后台脚本活跃
  },
  "browser_action": {
    "default_icon": {
      "48": "icon.png"
    },
    "default_title": "Start Writing"
  }
}

2. 重写background.js #

Firefox WebExtensions没有getDirectory/createWriter这类直接写入文件的API，需通过downloadsAPI实现文件追加写入：

// 捕获全局错误
browser.runtime.onError.addListener((err) => {
  console.error('Runtime error:', err);
});

let intervalId = null;

// 点击插件图标启停定时任务
browser.browserAction.onClicked.addListener(() => {
  if (intervalId) {
    clearInterval(intervalId);
    intervalId = null;
    browser.browserAction.setTitle({title: "Start Writing"});
    console.log("Stopped writing to file");
    return;
  }

  intervalId = setInterval(() => {
    // 带时间戳的写入内容，方便验证
    const content = `Hello, world! ${new Date().toLocaleString()}\n`;
    const blob = new Blob([content], {type: "text/plain"});
    const blobUrl = URL.createObjectURL(blob);

    browser.downloads.download({
      url: blobUrl,
      filename: "my-file.txt",
      conflictAction: "append" // 追加到已有文件而非覆盖
    }).then((downloadId) => {
      console.log("Successfully wrote to file, download ID:", downloadId);
      URL.revokeObjectURL(blobUrl); // 释放内存
    }).catch((error) => {
      console.error("Failed to write file:", error);
      URL.revokeObjectURL(blobUrl);
    });
  }, 10000); // 每10秒执行一次

  browser.browserAction.setTitle({title: "Stop Writing"});
  console.log("Started writing to file every 10 seconds");
});

三、测试步骤 #

1. 在about:debugging页面加载修改后的插件；
2. 点击插件图标启动任务，查看后台控制台日志；
3. 打开浏览器默认下载文件夹，检查my-file.txt是否持续追加内容；
4. 再次点击插件图标可停止任务。

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