fs.rename(oldPath, newPath, callback)

版本历史

版本	变更
v18.0.0	Passing an invalid callback to the `callback` argument now throws `ERR_INVALID_ARG_TYPE` instead of `ERR_INVALID_CALLBACK`.
v10.0.0	The `callback` parameter is no longer optional. Not passing it will throw a `TypeError` at runtime.
v7.6.0	The `oldPath` and `newPath` parameters can be WHATWG `URL` objects using `file:` protocol. Support is currently still experimental.
v7.0.0	The `callback` parameter is no longer optional. Not passing it will emit a deprecation warning with id DEP0013.
v0.0.2	新增于: v0.0.2

oldPath <string> | <Buffer> | <URL>
newPath <string> | <Buffer> | <URL>
callback <Function>
- err <Error>

异步将位于 oldPath 的文件重命名为提供的 newPath 路径。如果 newPath 已存在，它将被覆盖。如果 newPath 是一个目录，则会引发错误。完成回调中除了可能的异常，不会提供其他参数。

🌐 Asynchronously rename file at oldPath to the pathname provided as newPath. In the case that newPath already exists, it will be overwritten. If there is a directory at newPath, an error will be raised instead. No arguments other than a possible exception are given to the completion callback.

另请参见：rename(2)。

🌐 See also: rename(2).

import { rename } from 'node:fs';

rename('oldFile.txt', 'newFile.txt', (err) => {
  if (err) throw err;
  console.log('Rename complete!');
});