Node.js fs.promises.appendFile() 方法

在 Node.js 中，fs (file system) 模块提供了许多操作文件和目录的方法，其中一个方法是 fs.promises.appendFile()。这个方法可以用来向一个文件中追加内容。

核心语法

以下是 fs.promises.appendFile() 方法的语法格式：

fs.promises.appendFile(path, data[, options])

• path ：要追加内容的文件路径。
• data ：要追加的内容，可以是字符串或 Buffer。
• options ：一个包含文件追加的选项的对象，可选的。

使用示例

假设我们有一个名为 app.log 的文件，现在想要将一些日志添加到文件中。 可以这样使用 fs.promises.appendFile() 方法：

const fs = require('fs').promises;

(async function() {
  try {
    // 追加内容到文件中
    await fs.appendFile('./app.log', 'This is a log message.\n');
    await fs.appendFile('./app.log', 'Another log message.\n');
    
    console.log('日志已添加到文件中。');
  } catch (error) {
    console.error(error);
  }
})();

此代码将向 ./app.log 文件中添加两行日志。 追加的内容是一个字符串，每行末尾都有一个换行符（\n）。

选项

fs.promises.appendFile() 方法可以使用以下选项：

• encoding：编码格式。
• mode：文件权限，默认为 0o666。
• flag：文件打开标记，例如 'a'(默认)。

这里是一个使用选项的例子：

const fs = require('fs').promises;

(async function() {
  try {
    await fs.appendFile('./app.log', 'This is a log message.\n', { encoding: 'utf8', mode: 0o666, flag: 'a' });
    
    console.log('日志已添加到文件中。');
  } catch (error) {
    console.error(error);
  }
})();

这将使用 utf8 编码追加内容，并且设置权限为 0o666。 flag 选项默认为 'a'，所以在这个例子中可以省略它。

错误处理

fs.promises.appendFile() 方法是异步的，因此需要使用异步错误处理模式。可以使用 try-catch 语句来处理错误，也可以使用 .then() 和 .catch() 方法来处理错误。

以下是使用 .then() 和 .catch() 方法的例子：

const fs = require('fs').promises;

fs.appendFile('./app.log', 'This is a log message.\n')
  .then(() => {
    console.log('日志已添加到文件中。');
  })
  .catch((error) => {
    console.error(error);
  });

这个例子中，当追加操作完成时，then 方法中的代码将被执行。 如果出现错误，catch 方法中的代码将被执行。

结论

fs.promises.appendFile() 方法是一个很好用的方法，可以很方便地将内容追加到一个文件中。这个方法的选项也提供了更多的灵活性，可以根据需要进行配置。如果你需要往文件中添加一些日志或其他信息，fs.promises.appendFile() 方法是个不错的选择。