如何通过Firefox扩展在Firefox配置文件内创建写入本地文本文件？

需要在Firefox扩展的后台脚本中每分钟多次静默创建并写入文本文件到Firefox配置文件文件夹，操作不能弹出文件资源管理器，且无法使用Storage API。

此前尝试的旧方案均已失效：

• 基于require的文件写入方案：无法运行
• 基于Components.classes的方案：Firefox 111+已弃用该API
• 用fetch写入扩展文件夹相对路径：无错误提示但未实际写入文件

方案1：利用文件系统访问API（需首次用户授权） #

该方案基于Web标准的File System Access API，首次需要用户选择目标目录（配置文件夹内的子目录），之后可静默高频写入。

1. 配置扩展权限 #

在manifest.json中添加权限：

{
  "permissions": ["fileSystem"]
}

2. 核心代码实现 #

// 首次运行时获取用户授权的目录句柄
async function getAuthorizedDir() {
  const dirHandle = await window.showDirectoryPicker({
    mode: "readwrite",
    startIn: "profile" // 引导用户打开Firefox配置文件夹
  });
  // 可将dirHandle存入内存（若不能用Storage API），后续复用
  return dirHandle;
}

// 写入文件到授权目录
async function writeFile(dirHandle, filename, content) {
  // 创建或获取文件句柄
  const fileHandle = await dirHandle.getFileHandle(filename, { create: true });
  // 创建可写入流并写入内容
  const writableStream = await fileHandle.createWritable();
  await writableStream.write(content);
  await writableStream.close();
}

// 示例：每分钟写入一次
let authorizedDir;
(async function init() {
  authorizedDir = await getAuthorizedDir();
  setInterval(async () => {
    await writeFile(authorizedDir, `log_${Date.now()}.txt`, `Current time: ${new Date().toISOString()}`);
  }, 60000);
})();

方案2：Native Messaging（完全静默，无用户授权） #

通过调用本地脚本实现文件写入，适合完全静默的高频操作，无需用户交互。

1. 编写本地处理脚本（以Node.js为例） #

创建file_writer.js：

const fs = require('fs');
const process = require('process');

// 读取扩展发送的消息
process.stdin.on('data', (data) => {
  try {
    const { targetPath, content } = JSON.parse(data.toString());
    // 写入文件
    fs.writeFileSync(targetPath, content, 'utf8');
    // 返回成功响应
    process.stdout.write(JSON.stringify({ success: true }) + '\n');
  } catch (err) {
    process.stdout.write(JSON.stringify({ success: false, error: err.message }) + '\n');
  } finally {
    process.stdout.end();
  }
});

2. 配置Native Messaging清单 #

创建com.your.extension.filewriter.json：

{
  "name": "com.your.extension.filewriter",
  "description": "Silent file writer for Firefox extension",
  "path": "/path/to/your/file_writer.js",
  "type": "stdio",
  "allowed_extensions": ["your-extension-id@example.com"]
}

将该文件放到对应系统的Native Messaging目录：

• Windows：%APPDATA%\Mozilla\NativeMessagingHosts\
• macOS：~/Library/Application Support/Mozilla/NativeMessagingHosts/
• Linux：~/.mozilla/native-messaging-hosts/

3. 扩展后台脚本调用代码 #

// 发送写入请求到本地脚本
async function writeViaNative(targetPath, content) {
  const port = browser.runtime.connectNative('com.your.extension.filewriter');
  port.postMessage({ targetPath, content });
  
  port.onMessage.addListener((response) => {
    if (!response.success) {
      console.error('File write failed:', response.error);
    }
  });
  
  port.onDisconnect.addListener(() => {
    if (browser.runtime.lastError) {
      console.error('Native messaging error:', browser.runtime.lastError.message);
    }
  });
}

// 示例：每分钟写入配置文件夹内的log.txt
const profileLogPath = "/path/to/firefox/profile/folder/log.txt"; // 需预先确定配置文件夹路径
setInterval(() => {
  writeViaNative(profileLogPath, `Current time: ${new Date().toISOString()}\n`);
}, 60000);

补充：获取Firefox配置文件夹路径 #

可通过Native脚本读取系统环境变量或注册表（Windows）、配置文件（macOS/Linux）来自动获取Firefox配置文件夹路径，避免硬编码。

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