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!');
});