Node.js fsPromises.rename() 方法

fsPromises.rename() 方法是 Node.js 内置 fs 模块中提供的一个功能强大的方法，用于对文件或目录进行重命名操作。该方法返回一个 Promise，以支持异步操作。

语法

fsPromises.rename(oldPath, newPath)
  .then(() => {
    // 文件/目录重命名成功的处理逻辑
  })
  .catch((error) => {
    // 文件/目录重命名失败的错误处理逻辑
  });

参数

• oldPath：需要重命名的文件或目录的旧路径。
• newPath：文件或目录的新路径。

返回值

fsPromises.rename() 方法返回一个 Promise。

• 如果重命名操作成功，则 Promise 将会被 resolved，将传递一个 undefined 的值给后续处理逻辑。
• 如果重命名操作发生错误，则 Promise 将会被 rejected，并将错误对象传递给后续的错误处理逻辑。

示例

以下示例演示了如何使用 fsPromises.rename() 方法将文件重命名：

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

fsPromises.rename('./path/to/oldfile.txt', './path/to/newfile.txt')
  .then(() => console.log('文件重命名成功'))
  .catch((error) => console.error('文件重命名失败: ', error));

注意事项

• fsPromises.rename() 方法可以对文件和目录进行重命名操作。
• 如果新路径与已存在的文件或目录重名，则会覆盖原有的文件或目录。
• 在 Windows 上，重命名操作可能受到操作系统文件锁定的限制，因此可能无法对某些文件进行重命名操作。

通过使用 fsPromises.rename() 方法，您可以轻松地在 Node.js 中对文件和目录进行重命名操作，无需处理回调函数，而且操作更加简单和优雅。